Maps API for Javascript FAQ
[B]Q: What is the HERE Map API for JavaScript?[/B]
The HERE Map API is a JavaScript API with an extensive set of map features and services, and comes with a convenient test environment (Playground) for Web developers. You can use this service to display interactive maps of a given geographical position, with overlays such as markers, polylines, polygons and heatmap data. The API also offers a rich set of functions to render various map types, manage the UI, perform searches and and calculate and display routes. The API works with both desktop and mobile browsers
[B]Q: Where can I find examples of the API in action?[/B]
The best place to start would be to look at the Developer Playground Examples, to get to the latest version, follow the link [url]http://developer.here.com/javascript_api_explorer[/url]
Further examples can be found on the Community Wiki:
[url]http://www.developer.nokia.com/Community/Wiki/Portal:HERE_Maps_API_for_Web[/url]
[B]Q: Where do I get an app_id and token?[/B]
[LIST=1][*] Open the HERE Developer Site - [url]http://developer.here.com/[/url] and in the top-right corner click Sign in, then pick one option:
[LIST][*] Log in with your HERE account credentials – you may need to create an account first.[*] Log in with your Facebook account credentials.[/LIST][*] Open My Apps, click Create App and follow the on-screen instructions.[/LIST]
see : [url]http://www.developer.nokia.com/Community/Wiki/How_to_Obtain_Your_Own_Nokia_appID_and_Token[/url]
[B]Q: How do I generate an new app_id and token.[/B]
1) Log in to [url]http://developer.here.com/[/url]
2) Click on NEW APP.
3) Once an app_id and token pair is generated, click on the name of your app to see the details, you should see something like:
[B]testappid [/B]
[B]App ID:[/B] zqq7NvxXXXXXXXk6zgAE
[B]Token:[/B] UFgJ8GuXXXXXXXlkizjrD%3D%3D
The token is the longer string of the two, the app_id is the shorter string do not use the name of the app.
You should generate a new app id for each application you create.
[B]Q: Where is the reference documentation for this API ?[/B]
The current API reference can be found at: [url]http://developer.here.com/maps_js[/url]
[B]Q: What is the relationship between the HERE Map API and the Ovi Map API?[/B]
Version 1.0 of the HERE Map API used the old Ovi branding, the HERE Map API has superseded this.
To upgrade from the Ovi Maps API to the HERE Maps, two changes are required in the code:
1) Replace [url]http://api.maps.ovi.com/jsl.js[/url] with [url]http://api.maps.nokia.com/2.2.4/jsl.js[/url] because the API is hosted in a different domain.
2) Replace all instances of ovi.mapsapi with nokia.maps since the objects are created in a different namespace.
Note the version number is now part of the URL for the JS Library, this will update as further releases occur
Further details can be found in the [URL="http://www.developer.nokia.com/Community/Wiki/Converting_Ovi_Maps_to_HERE_Maps"]Converting Ovi Maps wiki[/URL] article
[B]Q: I think I have discovered a bug, how should I go about reporting it?[/B]
When reporting a bug for the NokiaMaps API on this discussion board, please utilize the template below. Select and fill the details depending which sections are valid for your case. The more data you can provide the better; code to test out, screen shots...
[LIST][*]Hardware: DESKTOP | MOBILE | BOTH <target hardware(s)>[*]OS Version: XP VISTA | MAC O/S | IPAD | IPHONE <operating system(s) the bug appeared on>[*]Browser and Version: IE | FIREFOX | CHROME | SAFARI <browser(s) the bug appeared on>[*]Steps to reproduce: (example code | instructions) <code, instructions - even this behaviour does not occur every time or only occurred once>[*]Actual Results: (current output) <what actually happened>[*]Expected behaviour: <what should have happened>[*]Other details: <anything else you want to note that is relevant to the incident>[/LIST]
