Geocoder API

The Yandex.Maps service provides access to the Geocoder HTTP API. This API can determine the coordinates of a toponym using its address, or the address of a point using its coordinates. For example, the API can identify the delivery zone based on the address specified by the user.

This document describes the basic principles of working with the API and its usage examples.

You can find out how to use JavaScript API geocoding in the the JavaScript API documentation, the section Search on map.

Restriction. Systems that send a request to the Geocoder must support SNI (Server Name Indication), an extension of the TLS protocol.
  1. Types of geocoding
  2. Geocoder response format
  3. Getting started

Types of geocoding

Forward geocoding:
Forward geocoding is used for determining an object's coordinates based on its name or address. The API considers common typos and offers a number of suitable options. For example, you can convert a user-defined address to coordinates.
Reverse geocoding

Reverse geocoding is used for determining an object's address based on its coordinates. For example, you can select the house closest to the point on the map and get its name.

Note. For reverse geocoding, you can select the necessary type of toponym. For example, you can search for streets or localities only.

Geocoder response format

The geocoder response can be generated in the following formats:

Getting started

To get started with the Geocoder HTTP API, obtain a key for the “JavaScript API and Geocoder HTTP” package. You can find out the request format in the article HTTP geocoding request.