Home
This project is hosting the HERE Launchers API library and source codes, as well the demo application illustrating the use of the API. The documentation for the API is located at Lumia Developer's Library.
- Windows Phone development basics
- Windows Phone 8 SDK
- Read project's documentation in the Lumia Developer's Library.
- Download the project or clone the Git repository, if you are interested in its inner workings:
git clone https://github.com/Microsoft/here-launchers.git
The repository has the following structure:
- DLL: The HERE launcher library project
- Examples: Contains an example project which demonstrates the functionality enabled by the HERE Launchers library
- Libraries: The latest build of the HERE Launcher library, to be added to your project
- XAP: The latest builds of the example application
The DLL can be built without any additional settings. With the demo project you need to add WP toolkit and ensure that the DLL is included in the project correctly.
If you built new HERE Launchers binaries, copy them under the Bin\Debug and Bin\Release folders in the demo project. Otherwise utilise the ready-built XAP packages found in the repository. If there are any reference problems to the DLLs, just right-click the references in your project, select "Add Reference" from the pop-up menu, and then browse to the DLL.
To install the WP toolkit, click the "Tools" menu, select "Library Package Manager" to open sub menu, and select "Package manager Console" from the opened sub menu. Then type Install-Package WPtoolkit into the console and wait until the installation of the toolkit package is finished.
The structure of the demo application is really simple. When started, you first see the start screen as shown above. In this view you can simply start the different views used to demonstrate the usage of different functionalities provided by the HERE Launchers API.
The views used for selecting the actual functionality are shown below:
In each view you can fill in the required fields and then press the button located at the bottom of the view to launch the handler application for the functionality.
Special input handling is implemented for each location (latitude/longitude) input box, they accept input only as described below:
- '-' character can only be input as first character (long press of comma/dot button brings options for inputting minus sign).
- There can be only one decimal separator character.
- The separator character added to the input box is taken from locate settings.
- In input, both ',' and '.' characters are accepted as decimal separators.
- Invalid value is shown in red color.
Additionally, there is a location selection view which can be opened by pressing the "Get" button located on the right side of the views.
When pressing "Ok" in the location selection, the location in which the yellow dot marker is will be set as the selected location; pressing "Cancel" will cancel the location selecting.
When the dot in upper right corner of the map is green, then clicking it will move the map center to the location determined with the positioning API. The accuracy of the position will be shown with a green circle polygon drawn into the map.
The yellow dot marker can be moved by dragging it with finger; also when it is not shown in the visible area of the map, you can move it to selected location by tapping the map view.
Locations can also be found by using the Geocoding service. If there are multiple results for the query, then there will be a selection list located in the upper side of the map view. The yellow dot marker will be moved to the selected location once a result from the list is selected.