Geocoder API Developer's Guide


Note: This service is no longer being actively developed. We will only provide critical fixes for this service in future. Instead, use the new Geocoding and Search API v7 service.

This document introduces the Geocoder API and:

  • explains key concepts
  • provides examples
  • documents resources and query parameters
  • documents response structures and data types

For the terms and conditions covering this documentation, see the HERE Documentation License.

What Is the Geocoder API?

The HERE Geocoder API is a REST API that allows you to:

  • Obtain geocoordinates for addresses
  • Obtain addresses or administrative areas for locations
  • Obtain geocoordinates for known landmarks

Why Use the Geocoder API?

The Geocoder API provides resources to address the following high-level use cases:

Table 1. Main features of the HERE Geocoder API
Feature Description
Request geocoordinates for an address, also known as forward geocoding Submit an address to request the corresponding geocoordinates. Addresses may use structured input or free-form search strings with complete or partial address information. The more detailed the address you submit, the higher the potential match accuracy.
Request an address for a geocoordinate, also known as reverse geocoding Submit a geocoordinate and an optional radius to request the corresponding address.
Request geocoordinates for a known landmark, also known as landmark geocoding Submit the name of a known landmark to request the corresponding geocoordinates.