HERE Maps APIs for JavaScript

  1. What is the HERE Maps API for JavaScript?

    The HERE Maps API for JavaScript offers developers an extensive set of HERE Map features and services to integrate into their web applications.

  2. What is different with the new HERE Maps API for JavaScript 3.0? How is it different than the previous version?

    The new version 3.0 is completely redesigned. It combines all HERE Platform backend capabilities in one single API. It replaces both the previous JavaScript API and the Enterprise JavaScript Api.

    The functional highlights of the new version are:

    •          Single development for multiple screens and devices
    •          API Performance optimized for latest mobile and desktop technologies
    •          Full integration of Street Level imagery for immersive map experiences
    •          Venue maps functionality planned for next release
    •          Modular and flexible API design for optimum usage of features/API components in any applications

  3. Where can I find examples of the APIs in action?

    Examples of the HERE Maps API for JavaScript can be found in the interactive JavaScript API Explorer.

  4. What mobile OS and browsers do the new HERE Maps API for JavaScript 3.0 support?

    The HERE Map API for JavaScript 3.0 is optimized for the usage on mobile devices. It supports mobile browser like Chrome, Safari, Internet Explorer and Firefox on IOS, Android as well as Windows Phone 8+. Details about the supported versions can be found in the documentation.

HERE Maps RESTful Web Services

  1. Where can I find examples of the HERE Maps RESTful Web Services in action?

    Examples of the HERE Maps RESTful Web Services supporting B2C or consumer use cases for web can be found in the interactive REST API Explorer.

    Examples of the HERE Maps Enterprise RESTful Web Services supporting B2B or enterprise use cases can be found in the Enterprise API Explorer.

Developer Support

  1. Is there technical support? If so, which kind of support is provided?

    Specific questions on the use of the HERE Maps API can be asked on Stack Overflow. The HERE Maps API team actively monitors and responds to programming questions asked there regarding these APIs. We encourage all developers to share their knowledge by answering and asking questions in the here-location-api tag. For more information, see: About Stack Overflow and How to ask a good question on Stack Overflow.

    Customers with a paid plan can view dedicated support contact information on the dashboard.

  2. I think I have discovered a bug. How do I report it?

    The HERE Maps API stack overflow channel allows developers to determine if an issue has already been identified/reported and is currently being worked on by the HERE Maps API team. If you cannot find information about an issue there, you may report a new bug report by emailing us at developersupport@here.com. We encourage all developers to provide as much detail as possible on each bug/issue identified, including:

    • Screenshots or other images
    • Hardware: DESKTOP | MOBILE | BOTH <target hardware(s)>
    • OS Version: WIN 8| 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 when the  behavior does not occur every time or has only occurred once>
    • Actual Results: (current output) <what has actually happened>
    • Expected behavior: <what was expected to have happened>
    • Other details: <anything else that is relevant to the incident>

Licensing and Terms

  1. What licensing options are available for the HERE Maps APIs?

    Three licensing options are available for the HERE Platform:

    1. Free – Free monthly access to basic Maps, Directions, Geocoder and Places functionality for use on both commercial and non-commercial websites, subject to maximum monthly platform transaction limits. Only applicable for consumer-facing applications, i.e., applications where the end customers are business users are explicitly excluded. Please note, free plans do not include an SLA.
    2. Evaluation/Trial – 90-day license limited to non-commercial, internal evaluation of the full HERE Platform feature set. A monthly limit of 100,000 platform transactions applies. Transactions are defined below.
    3. Commercial (Paid) – Solutions for consumer-facing and enterprise-facing applications, including pre-defined monthly transaction volumes with overage fees for additional transactions. These plans include an SLA and support.

    For more information on our licensing options or to get started now, click here.

  2. What are the terms and conditions for your licensing options?

    Terms and conditions for all three licensing options are available here.

  3. What Service Level Agreement (SLA) do you offer?

    Service Level Agreements of 99.9% monthly availability are provided to commercial licensees of paid plans.

  4. I'm an independent developer and just want to test out the APIs. What do I need to do?

    The Base and Evaluation licensing options are the best choice for testing and evaluating the HERE Platform. To learn more about these options or to get started click here.

  5. Can I display results from HERE Platform APIs on non-HERE maps, e.g., display restaurants returned by the HERE Places API on a Google map?

    No, in order to preserve the quality and integrity of the HERE-powered user experience, you may not commingle¹ results from HERE APIs with maps from other providers.


    ¹Commingling refers to substituting, appending or supplementing HERE services or content with non-HERE service or content or vice-versa.

  6. Can I display results from HERE Platform independent from an underlying map e.g., return a list of restaurants from the Places API as text that is not a map?

    Yes, you may display results from HERE Platform independent of an underlying map or other imagery.

  7. Can I launch an application for commercial use using an Evaluation License?

    No, launching a commercial application using an evaluation license is not permitted.  You can upgrade your evaluation plan to a paid plan from your dashboard.

  8. I would like to build mapping functionality into my consumer-facing commercial OR non-commercial website. All access is free and I make no money from this site. Can I use the APIs for free?

    Yes, free access to  HERE Platform for both consumer-facing commercial and non-commercial websites is possible with the free plan, as long as the website activity is within the usage limits of the plan. An upgrade to a paid plan is required if usage limit are exceeded.

  9. I run a website/mobile app that makes money by providing additional premium content to subscribers. Do the usage rights for the APIs differ between the free and paid versions of my website/mobile app?

    No. Both the free and commercial (paid) licensing options may be used for consumer-facing applications, either commercial or non-commercial.

  10. I will monetize my mobile app by selling it through an app store or other transactions. Can I use the Base licensing option?

    Yes, the free licensing option can be used to create an app that will be monetized through an app store or other similar transactions. The 90-day evaluation license cannot be used for this purpose.

  11. I am a third-party developer who wants to develop multiple applications/websites for different customers. Can I use the same app_id?

    No, the same app_id cannot be used across multiple third-party implementations. Each application and business customer requires a separate app_id. 

  12. Is it possible to track the usage that my app is generating?

    Yes, our integrated developer dashboard allows you to track the usage your app is generating.

API Access Control

  1. How do you control access to Location APIs? Do I need to take any special precautions?

    HERE APIs use two random strings, app_id and app_code, to provide secure access to their services.

    HERE APIs use a combination of app_id and app_code to uniquely identify a user, an application, and to track usage for an application.

    app_id - Uniquely identifies your application.

    app_code – Is used in the authentication process to identify a session.

    Please note that the app_ids and app_codes generated for Evaluation only will expire 90 days from issuance.

  2. How do I generate an app_id and app_code for my application?

    To generate an app_id and app_code for an application, you need to sign in to view your application dashboard. Once there, click on the Create Application button and follow the steps to create a new application.

    Once a new application is create, an app_id and app_code is automatically generated for your particular application.

  3. Can I share app_id or app_code with other applications?

    No, each application you develop requires a separate app_id and app_code.

Payment and Subscription

  1. How can I upgrade my plan?

    You can upgrade your plan at any time via the dashboard.

    If you have an annual subscription, the upgrade will become effective immediately. You will only be charged for the pro-rated price difference.

    Monthly plans are updated at the start of the next billing period.

  2. How can I downgrade my plan?

    You can downgrade your plan at any time via the dashboard. Downgrades to monthly plans are effective from the start of the next billing period.

    Downgrades to annual plans are effective immediately. Pro-rated price differences when moving from a higher priced to a lower priced plan are non-refundable.

  3. How do I cancel my plan?

    You can cancel your plan at any time via the dashboard. From the 'My apps' page select 'App Details' for the plan you would like to cancel. Hover over the gear icon to the right of your application name and select the 'Cancel' option.
     
    The cancellation is effective at the end of the current billing cycle. Plan fees are non-refundable.

  4. How do I update my payment information?

    You can change your billing details at any time via the Account Management section of the dashboard.

  5. How can I access statements and invoices?

    All invoices are sent by email and available to download from the Account Management section of the dashboard.

  6. What payment methods can I use to purchase a paid subscription plan?

    We accept Visa, MasterCard, American Express and Paypal, depending on your billing country. US customers can also pay with Discover card.

    We offer net terms payments on request for Enterprise customers. Please contact us to arrange.

  7. Can I pay annually instead of monthly?

    Yes. You can choose between monthly or annual billing while signing up for a plan.

  8. What currencies can I use to make a payment?

    We currently bill in Euros or US Dollars. Your billing currency is determined by your billing address. Your card provider may charge an exchange fee.

  9. I have a question about billing, who do I contact?

    We have regional billing support available.

    In Europe, Middle East and Africa:
    Email selfservesupport_emea@here.com
    Austria, Belgium,  Cyprus, Czech Republic, Finland, France, Germany, Hungary, Iceland, Ireland, Italy, Luxembourg, Norway, Poland, Spain, Sweden, the Netherlands, and the UK: 00-800-1823-5322
    All other countries: +31-55-538-4245
     
    In North and South America:
    Email selfservesupport_amer@here.com
    USA and Canada: 866-472-8590
    Mexico: 01-800-557-5539
    Brazil: 0800-0957329
    Chile: 800-835-217
    Columbia: 01-800-518-2793
    Argentina: 0800-4444240 or 0800-6660366
    All other countries: +1-801-431-1531  
     
    In Asia Pacific:
    Email selfservesupport_apac@here.com
    Australia: 1800 085 406
    India: 000-800-440-2095
    New Zealand: 0800-027-812
    All other countries:  +65-67200221

  10. How are HERE Platform transactions counted?

    One request to HERE Platform is equal to one transaction for all features, except in the case of:

    • Map, satellite and traffic tiles, for which a transaction equals 15 requests.  
    • Batch geocoding, for which the number of transactions equals the number of individual geocoding requests.
    • Multi-reverse geocoding, for which the number of transactions equals the number of individual reverse geocoding requests.
    • Venue Models, for which a transaction is equal to a json model within a Venue Maps request.  
    • Street Level Imagery, for which a transaction is equal to a request of a 360 degree view from current location

  11. What happens if I use more transactions than I have paid for?

    If you go over your monthly usage allowance,  overage fees will be applied to your account. Overage fees are charged on a per transaction basis as follows:

    Consumer Mapping:
    $0.0007 USD / transaction
    €0.0005 EUR / transaction

    Enterprise Mapping:
    $0.0100 USD / transaction
    €0.0070 EUR / transaction

    Geocoding:
    $0.0020 USD / transaction
    €0.0016 EUR / transaction

    Overage fees will be charged in arrears on a monthly basis for both monthly and annual subscriptions.

    This does not impact the functionality of your apps. We will also send email notifications when you are approaching your limit.

  12. Will my paid plan give me access to all features in all countries?

    Yes. Our global coverage is constantly  being updated. Some services are not currently available in all countries.

    For a geographic breakdown of coverage information please visit our coverage page.

  13. How do I buy access to Mobile SDKs, Mobile Asset Management and other HERE Products not available to purchase on this site?

    Please contact us for more information.

  14. Do you provide plans for universities and non-profits organizations?

    Yes. Please contact us for information on specific plans for universities and other non-profit organizations.   

Mobile SDKs

  1. Where can I get more information on the HERE Mobile SDKs?

    For more information on our Mobile SDKs please contact us. A HERE Representative will respond to you shortly.

  2. What licensing options are available for HERE Mobile SDKs?

    Two licensing options are available: for Business and for OEM customers. Each option is governed by different terms and conditions so please make sure you refer to the one applicable to your development.

  3. How can I evaluate the HERE Mobile SDKs? Is there a free trial available?

    An evaluation SDK is available for customers to test our services for free for 90 days. After 90 days, customers need to contact us to receive a commercial key for use in their application. To get access to the evaluation SDK please contact us.