643 matches
7 actions
Interactive documentation for your Premium plan
7 actions
Other/Interactive documentation for your Premium plan
You can use this endpoint to find the nearest place from given coordinates.
Note: If you specify coordinates of a secluded place (e.g. middle of the ocean), the nearest point can be very far from the coordinates.
{
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "Your unique API key. You can either specify it in this parameter, or set it in `X-API-Key` header."
},
"language": {
"description": "The language of text summaries and place names (variable names are never translated). Available languages are:\n\n * ``en``: English\n * ``es``: Spanish\n * ``fr``: French\n * ``de``: German\n * ``pl``: Polish\n * ``pt``: Portuguese\n * ``cs``: Czech\n",
"type": "object"
},
"lat": {
"type": "string",
"description": "Latitude in format 12N, 12.3N, 12.3, or 13S, 13.2S, -13.4"
},
"lon": {
"type": "string",
"description": "Longitude in format 12E, 12.3E, 12.3, or 13W, 13.2W, -13.4"
}
},
"required": [
"lat",
"lon"
],
"additionalProperties": false
}{
"type": "object",
"properties": {
"adm_area1": {
"type": "string",
"description": "first-level administrative area (a US state, for example)"
},
"adm_area2": {
"type": "string",
"description": "second-level administrative area (a US county, for example)"
},
"country": {
"type": "string",
"description": "name of the country"
},
"lat": {
"type": "string",
"description": "Latitude of the point, always in the format \\<float><N/S>, for example ``23.5S``"
},
"lon": {
"type": "string",
"description": "Longitude of the point, always in format \\<float><E/W>, for example ``23.5W``"
},
"name": {
"type": "string",
"description": "name of the place"
},
"place_id": {
"type": "string",
"description": "unique identifier of the place, which can be used in /point and /map endpoints"
},
"timezone": {
"type": "string",
"description": "Timezone of the point in tzinfo format."
},
"type": {
"type": "string",
"description": "The character of the place. May be one of the following values:\n\n* administrative areas (states, counties, districts...): ``administrative_area``\n* country: ``country``\n* a different political entity from a country (for example, a dependent teritory): ``political_entity``\n* villages, towns and cities: ``settlement``\n* air industry locations: ``airbase``, ``airfield``, ``heliport``, ``airport``, ``airport_terminal``\n* places related to water: ``bay``, ``channel``, ``fjord``, ``lake``, ``pond``, ``falls``, ``gulf``,\n ``harbor``, ``reservoir``, ``sea``, ``dam``, ``cape``, ``island``, ``peninsula``\n* places related to mountain areas: ``hill``, ``mountain``, ``peak``, ``valley``, ``volcano``, ``canyon``\n* other places related to nature: ``park``, ``reserve``, ``resort``, ``desert``\n* places based on postcodes: ``postcode``\n "
}
}
}