FAQs

General

  1. How do I evaluate the HERE Platform?

    HERE offers a free trial of its web APIs and Mobile SDKs. To register for a free trial, please signup.

    Please note that to access the following features we need to whitelist your evaluation app_id. Please contact us to request access to:

    • Batch Geocoding: allows the user to upload multiple addresses in a single file for geocoding.
    • Transit API Advanced Offering: access to advanced features of our Transit API, from early and late departures to real-time next departures and transit isoline.
    • Weather API: enrich mapping applications with weather-related data such as weather forecasts, severe weather alerts and astronomical information.
    • Fleet Connectivity Extension: RESTful web service that enables connectivity between a backend system and a navigation application.
    • Indoor Positioning: Premium Mobile SDK feature providing highly accurate indoor positioning within a given venue/space through signal strength measurements from Wi-Fi Access Points and / or Bluetooth Low Energy beacons.
    • Custom Route Extension: Build custom routes considering your own road restrictions and geometries
  2. Does HERE support SSL?

    Yes, SSL is supported on every HERE plan at no extra charge. HTTP and HTTPS is billed the same way.

  3. How can I report a map error or provide map feedback?

    You can report errors or edit roads, places or addresses directly on the HERE map using our Embedded Map Editor SDK and Map Feedback API.

JavaScript API

  1. Where can I find examples of the API in action?

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

  2. What mobile OS and browsers does the HERE Maps API for JavaScript 3.0 support?

    The HERE Maps 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.

  3. How can I migrate from HERE Maps API for JavaScript 2.x to 3.x?

    Please see the migration guide here.

Rest APIs

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

    Interactive examples can be found in the examples section in each REST service's documentation.

Platform Extensions

  1. Where can I find code examples?

    Code examples covering various use cases and implementations are available in the Documentation.

  2. Can I license a Platform Extension (e.g., Platform Data Extension, Route Match Extension) standalone?

    The HERE Platform Extensions are only licensed in conjunction with HERE Platform for Business services. They are designed to enhance the functionality currently available through the core services of the HERE Platform for Business.

  3. Are the Platform Extensions also integrated into the Mobile SDK?

    Currently, only the Custom Location Extension is integrated into the HERE Mobile SDK for Business, for both iOS and Android. The other Platform Extensions are available as RESTful web services.

  4. How can I get access to a Platform Extension?

    Please contact us for access.

  5. Do I need a new/additional app_id and app_code for accessing the Platform Extensions?

    No, but your existing credentials need to be whitelisted to allow you access to the Platform Extensions. Please contact your HERE Account Executive or use the contact us form to get access.

  6. Can I use a Platform Extension to get the toll costs for a GPS trace for a post cost analysis?

    Yes, this is possible through two different Extensions, the Route Match Extension and the Toll Cost Extension. The Route Match Extension will enable you to match the GPS trace to the HERE road network. The response received can then be used to calculate the toll cost for the route using the Toll Cost Extension.

Mobile SDKs

  1. What’s the difference between the Starter and Premium Edition of the HERE Mobile SDK?

    The Starter Edition provides access to location features that respond to the most popular mapping needs, seen today in a variety of consumer-type applications, while the Premium Edition provides access to functionality that is more targeted to support specific business use cases such as truck routing, historical traffic, hybrid/offline mapping and more.

    For more info, please visit our Mobile SDK product page here.

  2. How can I license or get more information on the HERE Mobile SDKs?

    Starter SDKs can be licensed as part of the Public or Business plans. To license or get more information on our Premium Mobile SDKs please contact us.

Developer Support

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

    Specific questions on the use of HERE Maps APIs and SDKs can be asked on Stack Overflow. The HERE Maps team actively monitors and responds to programming questions asked there regarding these APIs and SDKs. We encourage all developers to share their knowledge by answering and asking questions in the here-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 by logging in and going to their 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 team. If you cannot find information about an issue there, you may report a new bug report by emailing us at selfservesupport@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 | 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 happened>
    • Expected behavior: <what was expected to have happened>
    • Other details: <anything else that is relevant to the incident>
  3. How do I performance test on the HERE Platform?

    Customers may contact us to request a dedicated performance testing environment to meet their needs. You may not performance test against our Customer Integration Testing (CIT) or Production environments.

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

    Yes. After logging in, select 'Projects', then select the project for which you would like to view usage. On the 'Project Details' page, select 'View Usage Details'.

  5. Why can't I see usage for my app in the Usage Details section of my Project Details page?

    It can take around 48 hours for usage data to be available on this page.

Licensing & Terms

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

    Three licensing options are available for the HERE Platform on developer.here.com:

    1. Public Basic – Free monthly access to Standard features via our web APIs (RESTful and JavaScript) & Starter SDKs for use on both commercial and non-commercial websites, subject to maximum monthly limit of 15,000 platform transactions. This license is only applicable for consumer-facing applications, i.e., applications where the end customers are business users are explicitly excluded. Free plans do not include an SLA.
    2. Evaluation/Trial – 90-day free trial license limited to non-commercial, internal evaluation of the HERE Platform via either our web APIs or mobile SDKs. A monthly limit of 100,000 platform transactions applies. Only one Evaluation license per account is allowed.
    3. Commercial (Paid) – Solutions for public-facing and business applications. These plans include an SLA and support.

    For more information on these licensing options or to get started now, click here.
    For more information on additional licensing options, including Advanced Features and Fleet and Field Workforce Management use cases, please contact us.

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

    Terms and conditions for all licensing options available through developer.here.com are here.

  3. What's your Service Level Agreement (SLA)?

    Our SLA is 99.9% monthly availability for the following APIs: Map Image, Map Tile, Venue Maps, Routing, Geocoder, Batch Geocoder, Geocoder Autocomplete, Places, Traffic, and Positioning. This SLA comes with all our paid plans.

  4. What are your RPS limits and how are RPS calculated?

    Requests Per Second (RPS) means for each Application the number of Requests per second to HERE Services calculated as an average (number of Requests during a period of 5 minutes) to all of the APIs used to access the features listed for each subscription plan on developer.here.com.

    RPS limits are set out in the below table. Batch geocoding is excluded from these limits.

    Public Plans Business Plans
    Basic 1 N/A
    Starter 1 1
    Standard 2 2
    Pro 3 3
  5. I'm an independent developer and just want to test out the APIs. What do I need to do?

    The free Public Basic 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.

  6. 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, 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 services or content or vice-versa.

  7. Can I integrate the HERE RESTful web services with Leaflet?

    Yes, you can also use Oracle MapViewer and OpenLayers.

  8. 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.

  9. 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 Project Details page or contact us to license a plan appropriate for your needs if one is not available for purchase on developer.here.com.

    Please refer to our API Documentation on how to change from our Custom Integration Test (CIT) environment to our Production environment. Use of HERE’s CIT environment in a commercial application will count towards transaction limits and any overages will be subject to charges.

  10. 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 HERE Maps APIs for free?

    Yes, free access to HERE Platform for both consumer-facing commercial and non-commercial websites is possible with the free Public Basic plan if the website activity is within the usage limits of the plan (15,000 transactions per month). An upgrade to a paid plan is required if usage limits are exceeded.

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

    No. Both the Public Basic (free) and Public paid licensing options may be used for consumer-facing applications, whether the applications are free or paid versions.

  12. I will monetize my mobile app by selling it through an app store or other transactions. Can I use the Public Basic (free) 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 evaluation license cannot be used for this purpose.

  13. I am a third-party developer who wants to develop multiple apps/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 for each business customer requires a separate app_id. To generate an additional app_id, simply repeat the process to sign up for the appropriate plan.

API Access Control

  1. How do you control access to the HERE Platform? 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 licenses will expire 90 days after they are issued.

    For additional protection, you can associate specific domains, referrers or hostnames to an app id from the Project Details page.

  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 register for a plan on https://developer.here.com/plans. Once your project is created, you will have the option to generate app IDs & app codes for JavaScript/REST APIs and SDKs.

    Please note, it can take up to an hour for a new app_id to be whitelisted against all services.

  3. When can I use my new app_id?

    You can use your app_id and app_code straight away, however it can take up to one hour for new app credentials to be whitelisted against all HERE services.

  4. Can I share an app_id or app_code with other applications?

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

  5. Why can't I access Batch Geocoding, Weather API, Platform Data Extension, Custom Location Extension, Indoor Positioning or some features of the Transit API?

    Access to these features is further protected by whitelisting. If you've purchased a plan that includes these features, your app_ID will be whitelisted. If you would like to evaluate these features using an evaluation app_id, please contact us for access.

Payment and Subscription

  1. What is my billing period on a monthly or annual subscription purchase?

    Your account follows an anniversary billing cycle. Your anniversary date will be the date on which you register for your first plan. Any subsequent purchases will follow the same anniversary billing cycle as that of your first plan.

  2. How can I upgrade my plan?

    You can upgrade your plan at any time via your Project Details page. If you would like to upgrade your plan to something that’s not offered on developer.here.com, please contact us.

    Upgrades from evaluation to paid plans are effective immediately. Upgrades from one paid plan to another paid plan are effective at the start of your next billing period. We follow an anniversary billing cycle, which means the monthly billing period is based on the date of your first sign-up.

  3. How can I downgrade my plan?

    You can downgrade your plan at any time via your Project Details page.

    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.

  4. How do I cancel my plan?

    You can cancel your plan at any time. Login and select 'Projects' from the dropdown menu under your login name. Next, select the Project you would like to cancel. This will load the 'Project Details' page from which you can select the option to 'Cancel Project', which is in the 'Project Details' section of the page.

    The cancellation is effective at the end of the current billing cycle. Plan fees are non-refundable.

  5. How do I update my payment information?

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

  6. How can I access my invoices?

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

  7. 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. In Germany, we also accept direct debit.

  8. Can I pay annually instead of monthly?

    Yes. You can choose between monthly or annual billing while signing up for a plan. Additionally you may also move from monthly into annual billing through the “Manage Plan” section on the project details page.

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

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

  10. Who do I contact about billing questions?

    For any billing support questions, please email selfservesupport@here.com. We try to answer all enquiries within one business day.

  11. 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
  12. What happens if I use more transactions than I have paid for?

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

    Public Plans:
    $0.0005 USD / transaction
    €0.0005 EUR / transaction

    Business Plans:
    $0.005 USD / transaction
    €0.005 EUR / transaction

    Overage fees are charged monthly in arrears for monthly subscriptions.

    Overage fees on annual subscriptions will be charged monthly in arrears as soon as the annual transaction limit is crossed during the annual term. The transaction limit will be reset at the start of the next annual term.

    Incurring overage fees does not impact the functionality of your apps. For both monthly and annual subscriptions, we will send email notifications when you are approaching your limit.

  13. Why does my statement have overage fees that don’t match the rates listed above?

    When a usage record is loaded into our billing system that results in a plan crossing its monthly quota, the price applied to that usage record is pro-rated to account for the portion that is included in your monthly quota for free and the portion that is billable. Subsequent usage records above your monthly quota will show at the per transaction prices listed on this website.

  14. Will my paid plan give me access to included 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. For specific questions, please contact us.

  15. How do I buy access to HERE products not available to purchase on this site?

    Please contact us.