Request format

All params
  ? apikey=<string>
  & geocode=<string>
  & lang=<string>
  & [kind=<string>]
  & [rspn=<boolean>]
  & [ll=<number>, <number>]
  & [spn=<number>, <number>]
  & [bbox=<number>,<number>~<number>,<number>]
  & [results=<integer>]
  & [skip=<integer>]
  & [uri=<string>]


Required parameter

The key issued in the Mappable Account.


Key activation takes up to 15 minutes.


Required parameter

Address or coordinates of the object being searched for. The specified data determines the type of geocoding:

  • If an address is specified, it is converted to object coordinates. This process is called forward geocoding.
  • If coordinates are specified, they are converted to the object's address. This process is called reverse geocoding.

Several formats for entering coordinates are available.


Required parameter

Language of the response and regional settings of the map.

Record format lang=language_region, where:

  • language — Two-letter language code. Specified in ISO 639-1 format. Sets the language for displaying the names of geographical features.
  • region — Two-letter country code. Specified in ISO 3166-1 format. Determines regional settings.

Example: lang=en_US.


Only if the geocode parameter sets the coordinates. The type of required toponym. List of accepted values:

  • house — house
  • street — street
  • metro — subway station
  • district — city district
  • locality — locality (city, town, village, etc.)

If omitted, the API will choose the toponym type automatically.


Flag indicating whether the search scope should be restricted to the specified area. The area is defined by the ll and spn or bbox parameters. Possible values:

  • 0 — Do not restrict search.
  • 1 — Restrict search.

Default value: 0.


If the geocode parameter sets the coordinates, the rspn parameter is ignored.


Longitude and latitude of the center of the search area. The span of the search area is set in the spn parameter.


The span of the search area. The center of the area is set in the ll parameter.
Set by two numbers:

  • the first is the difference between the maximum and minimum longitude of the area;
  • the second is the difference between the maximum and minimum latitude.


If the geocode parameter sets the coordinates and the kind parameter value is district, the spn parameter is ignored.


An alternative method for setting the search area.

The borders are defined as the geographical coordinates of the lower-left and upper-right corners of the area (in the order "longitude, latitude").

Record format: bbox=x1,y1~x2,y2


If bboxand ll+spn are used simultaneously, the bbox parameter takes priority.

Ignored if the geocode parameter sets the coordinates.


Maximum number of objects to be returned. If the skip parameter is set, its value must be set explicitly.

Default value: 10.

Maximum value: 50.


The number of objects to skip in the response, starting from the first one. If this parameter is set, the results parameter must also be set. The value of the skip parameter must divide evenly by the value of the results parameter.
Default value: 0.


Additional information about the object. The parameter value is returned in the Geosuggest response. To use it in a request, specify a value instead of text and coordinates.

Format for geographical coordinates in the request

Geographical coordinates in the geocode parameter are set sequentially in one of the following formats:

Record format Order of coordinates Example
+-float, +-float Longitude, latitude 134.854, -25.828
float [direction], float [direction]* Any E134.854, S25.828 134.854E, 25.828S
+-deg° mm' ss", +-deg° mm' ss" Latitude, longitude -25°49′41.1″, 134°51′15.88″
deg° mm' ss" [direction], deg° mm' ss" [direction]* Any 25°49′41.1″S, 134°51′15.88″E
NMEA Any 2549.67,S, 13451.26,E

* [direction] - The letter designation of one of the four directions: N, E, W, S. - Spaces are allowed between letters and coordinates.

Spaces, commas, or semicolons can be used as delimiters. Spaces are allowed on either side of the delimiter character.


The ";" character should be encoded as "%3B".