Custom Location Extension API Developer's Guide

HTTP Status Codes

The Custom Location Extension API uses the standard HTTP status codes to indicate the status of the request. In the case of errors, the Custom Location Extension API attempts to provide additional information for troubleshooting.

Status Code Comments
200 OK Service successfully processed the request
400 Bad Request Check the response for any possible messages for additional troubleshooting information. Examples of possible troubleshooting information include the following:
  • The bounding box definition is not well formed – Typically, a parameter in the request is misformed. Check the API Reference to ensure that you are using the correct parameters.
  • Layer does not exist – The layer referenced in the request parameter layer_id does not contain information or you do not have access rights to that layer.

    To confirm you have access to the layer, check the parameter layer_id in your request or the Administration Website User Guide. To access the Administration Website User Guide, open the API Version History page, browse to Custom Location API, and select User Guide.

  • Required parameters have not been provided – Typically, a parameter in the request is misformed. Check the API Reference to ensure that you are using the correct parameters.

  • Required String parameter 'layer_id' is not present – The parameter mentioned in the message varies depending on what is missing. Check the API Reference to ensure that you are using the correct parameters.

401 Unauthorized Check the response for any possible messages for additional troubleshooting information.

For example, the message may read: This is not a valid app_id and app_code pair. Please verify that the values are not swapped between the app_id and app_code and the values provisioned by HERE (either by your customer representative or via http://developer.here.com/myapps) were copied correctly into the request.

500 Internal Server Error Check the response for any possible messages for additional troubleshooting information.

For example, the message may read: Unable to complete request – Check that the request is properly formatted.

You cannot use this account to purchase a commercial plan on Developer Portal, as it is already associated to plans with different payment methods.

To purchase a commercial plan on Developer Portal, please register for or sign in with a different HERE Account.

Something took longer than expected.

The project should be available soon under your projects page.

Sorry, our services are not available in this region.

Something seems to have gone wrong. Please try again later.

We've detected that your account is set to Australian Dollars (AUD).
Unfortunately, we do not offer checkouts in AUD anymore.
You can continue using your current plan as normal, but to subscribe to one of our new plans,
please register for a new HERE account or contact us for billing questions on selfservesupport@here.com.