Introduction
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:
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. |