API Geocoding Reverse
Introduce
The Geocoding Reverse API allows you to determine an ADDRESS from input coordinates or vice versa, you can determine COORDINATES from an input address.
Params
GET https://dev.toptopmap.com/api/v1/maps/reverse-geocoding?key=APIKey&latlng=21.0296938,105.7749161&language=vi
| Parameter | Type | Description |
|---|---|---|
key | string | Required. API Key obtained from TOPTOP Maps |
latlng | string | Required. Coordinates or address, for example: 20.981971,105.864323 or 2 Nguyen Hoang |
language | string | Required. Language, for example: en, vi |
Sample request
curl --location 'https://dev.toptopmap.com/api/v1/maps/reverse-geocoding?key=APIKey&latlng=21.0296938%2C105.7749161&language=vi'
Responses
{
"status": "OK",
"plus_code": {
"compound_code": "2QHF+VXF Nam Từ Liêm, Hà Nội, Việt Nam",
"global_code": "7PH72QHF+VXF"
},
"results": [
{
"address_components": [
{
"long_name": "199",
"short_name": "199",
"types": [
"street_number"
]
},
{
"long_name": "Phố Trần Bình",
"short_name": "P. Trần Bình",
"types": [
"route"
]
},
{
"long_name": "Nam Từ Liêm",
"short_name": "Nam Từ Liêm",
"types": [
"administrative_area_level_2",
"political"
]
},
{
"long_name": "Hà Nội",
"short_name": "Hà Nội",
"types": [
"administrative_area_level_1",
"political"
]
},
{
"long_name": "Việt Nam",
"short_name": "VN",
"types": [
"country",
"political"
]
}
],
"formatted_address": "199 Phố Trần Bình, Mỹ Đình, Nam Từ Liêm, Hà Nội, Việt Nam",
"geometry": {
"bounds": {
"northeast": {},
"southwest": {}
},
"location": {
"lat": 21.0296672,
"lng": 105.7748973
},
"location_type": "ROOFTOP",
"viewport": {
"northeast": {
"lat": 21.0310161802915,
"lng": 105.7762462802915
},
"southwest": {
"lat": 21.0283182197085,
"lng": 105.7735483197085
}
}
},
"place_id": "ChIJv1_-crFUNDERWrO9orar3tI",
"types": [
"establishment",
"point_of_interest"
],
"distance": 3.543,
"plus_code": {
"compound_code": "2QHF+VX Nam Từ Liêm, Hà Nội, Việt Nam",
"global_code": "7PH72QHF+VX"
},
"secondary_text": "199 Phố Trần Bình, Mỹ Đình, Nam Từ Liêm, Hà Nội, Việt Nam",
"sort_distance": -496.457
},
{
"address_components": [
{
"long_name": "172-258",
"short_name": "172-258",
"types": [
"street_number"
]
},
{
"long_name": "Phố Trần Bình",
"short_name": "P. Trần Bình",
"types": [
"route"
]
},
{
"long_name": "Từ Liêm",
"short_name": "Từ Liêm",
"types": [
"administrative_area_level_2",
"political"
]
},
{
"long_name": "Hà Nội",
"short_name": "Hà Nội",
"types": [
"administrative_area_level_1",
"political"
]
},
{
"long_name": "Việt Nam",
"short_name": "VN",
"types": [
"country",
"political"
]
}
],
"formatted_address": "172-258 Phố Trần Bình, Mỹ Đình, Từ Liêm, Hà Nội, Việt Nam",
"geometry": {
"bounds": {
"northeast": {
"lat": 21.0297665,
"lng": 105.775111
},
"southwest": {
"lat": 21.0295658,
"lng": 105.7747673
}
},
"location": {
"lat": 21.0296662,
"lng": 105.7749391
},
"location_type": "GEOMETRIC_CENTER",
"viewport": {
"northeast": {
"lat": 21.0310151302915,
"lng": 105.7762881302915
},
"southwest": {
"lat": 21.0283171697085,
"lng": 105.7735901697085
}
}
},
"place_id": "ChIJLW1acrFUNDER9skOobJkQ0Y",
"types": [
"route"
],
"distance": 3.888,
"plus_code": {},
"secondary_text": "172-258 Phố Trần Bình, Mỹ Đình, Từ Liêm, Hà Nội, Việt Nam",
"sort_distance": 3.888
},
{
"address_components": [
{
"long_name": "212",
"short_name": "212",
"types": [
"street_number"
]
},
{
"long_name": "Phố Trần Bình",
"short_name": "P. Trần Bình",
"types": [
"route"
]
},
{
"long_name": "Từ Liêm",
"short_name": "Từ Liêm",
"types": [
"administrative_area_level_2",
"political"
]
},
{
"long_name": "Hà Nội",
"short_name": "Hà Nội",
"types": [
"administrative_area_level_1",
"political"
]
},
{
"long_name": "Việt Nam",
"short_name": "VN",
"types": [
"country",
"political"
]
}
],
"formatted_address": "212 Phố Trần Bình, Mỹ Đình, Từ Liêm, Hà Nội, Việt Nam",
"geometry": {
"bounds": {
"northeast": {},
"southwest": {}
},
"location": {
"lat": 21.0296679,
"lng": 105.7749422
},
"location_type": "RANGE_INTERPOLATED",
"viewport": {
"northeast": {
"lat": 21.0310168802915,
"lng": 105.7762911802915
},
"southwest": {
"lat": 21.0283189197085,
"lng": 105.7735932197085
}
}
},
"place_id": "EkAyMTIgUC4gVHLhuqduIELDrG5oLCBN4bu5IMSQw6xuaCwgVOG7qyBMacOqbSwgSMOgIE7hu5lpLCBWaWV0bmFtIhsSGQoUChIJLW1acrFUNDER9skOobJkQ0YQ1AE",
"types": [
"street_address"
],
"distance": 3.954,
"plus_code": {},
"secondary_text": "212 Phố Trần Bình, Mỹ Đình, Từ Liêm, Hà Nội, Việt Nam",
"sort_distance": 3.954
},
{
"address_components": [
{
"long_name": "258",
"short_name": "258",
"types": [
"street_number"
]
},
{
"long_name": "Phố Trần Bình",
"short_name": "P. Trần Bình",
"types": [
"route"
]
},
{
"long_name": "Cầu Giấy",
"short_name": "Cầu Giấy",
"types": [
"administrative_area_level_2",
"political"
]
},
{
"long_name": "Hà Nội",
"short_name": "Hà Nội",
"types": [
"administrative_area_level_1",
"political"
]
},
{
"long_name": "Việt Nam",
"short_name": "VN",
"types": [
"country",
"political"
]
}
],
"formatted_address": "258 Phố Trần Bình, Mai Dịch, Cầu Giấy, Hà Nội, Việt Nam",
"geometry": {
"bounds": {
"northeast": {},
"southwest": {}
},
"location": {
"lat": 21.029752,
"lng": 105.7747913
},
"location_type": "ROOFTOP",
"viewport": {
"northeast": {
"lat": 21.0311009802915,
"lng": 105.7761402802915
},
"southwest": {
"lat": 21.0284030197085,
"lng": 105.7734423197085
}
}
},
"place_id": "ChIJMxNRPPJVNDERjACGtETckHQ",
"types": [
"street_address"
],
"distance": 14.48,
"plus_code": {
"compound_code": "2QHF+WW Cầu Giấy, Hà Nội, Việt Nam",
"global_code": "7PH72QHF+WW"
},
"secondary_text": "258 Phố Trần Bình, Mai Dịch, Cầu Giấy, Hà Nội, Việt Nam",
"sort_distance": 29.48
},
{
"address_components": [
{
"long_name": "187",
"short_name": "187",
"types": [
"street_number"
]
},
{
"long_name": "Phố Trần Bình",
"short_name": "P. Trần Bình",
"types": [
"route"
]
},
{
"long_name": "Nam Từ Liêm",
"short_name": "Nam Từ Liêm",
"types": [
"administrative_area_level_2",
"political"
]
},
{
"long_name": "Hà Nội",
"short_name": "Hà Nội",
"types": [
"administrative_area_level_1",
"political"
]
},
{
"long_name": "Việt Nam",
"short_name": "VN",
"types": [
"country",
"political"
]
}
],
"formatted_address": "187 Phố Trần Bình, Mỹ Đình, Nam Từ Liêm, Hà Nội, Việt Nam",
"geometry": {
"bounds": {
"northeast": {
"lat": 21.0296701,
"lng": 105.7751583
},
"southwest": {
"lat": 21.0296251,
"lng": 105.7750739
}
},
"location": {
"lat": 21.0296476,
"lng": 105.7751089
},
"location_type": "ROOFTOP",
"viewport": {
"northeast": {
"lat": 21.0309965802915,
"lng": 105.7764650802915
},
"southwest": {
"lat": 21.0282986197085,
"lng": 105.7737671197085
}
}
},
"place_id": "ChIJK3SBcbFUNDERDvMBsFgIh2o",
"types": [
"premise"
],
"distance": 20.659,
"plus_code": {},
"secondary_text": "187 Phố Trần Bình, Mỹ Đình, Nam Từ Liêm, Hà Nội, Việt Nam",
"sort_distance": 35.659
},
{
"address_components": [
{
"long_name": "2QHF+VX",
"short_name": "2QHF+VX",
"types": [
"plus_code"
]
},
{
"long_name": "Nam Từ Liêm",
"short_name": "Nam Từ Liêm",
"types": [
"administrative_area_level_2",
"political"
]
},
{
"long_name": "Hà Nội",
"short_name": "Hà Nội",
"types": [
"administrative_area_level_1",
"political"
]
},
{
"long_name": "Việt Nam",
"short_name": "VN",
"types": [
"country",
"political"
]
}
],
"formatted_address": "2QHF+VX Nam Từ Liêm, Hà Nội, Việt Nam",
"geometry": {
"bounds": {
"northeast": {
"lat": 21.02975,
"lng": 105.775
},
"southwest": {
"lat": 21.029625,
"lng": 105.774875
}
},
"location": {
"lat": 21.0296938,
"lng": 105.7749161
},
"location_type": "GEOMETRIC_CENTER",
"viewport": {
"northeast": {
"lat": 21.0310364802915,
"lng": 105.7762864802915
},
"southwest": {
"lat": 21.0283385197085,
"lng": 105.7735885197085
}
}
},
"place_id": "GhIJ2-RLA5oHNUARNamyOZhxWkA",
"types": [
"plus_code"
],
"plus_code": {
"compound_code": "2QHF+VX Nam Từ Liêm, Hà Nội, Việt Nam",
"global_code": "7PH72QHF+VX"
},
"secondary_text": "2QHF+VX Nam Từ Liêm, Hà Nội, Việt Nam",
"sort_distance": 1000
},
{
"address_components": [
{
"long_name": "Mỹ Đình 2",
"short_name": "Mỹ Đình 2",
"types": [
"political",
"sublocality",
"sublocality_level_1"
]
},
{
"long_name": "Từ Liêm",
"short_name": "Từ Liêm",
"types": [
"administrative_area_level_2",
"political"
]
},
{
"long_name": "Hà Nội",
"short_name": "Hà Nội",
"types": [
"administrative_area_level_1",
"political"
]
},
{
"long_name": "Việt Nam",
"short_name": "VN",
"types": [
"country",
"political"
]
}
],
"formatted_address": "Mỹ Đình 2, Từ Liêm, Hà Nội, Việt Nam",
"geometry": {
"bounds": {
"northeast": {
"lat": 21.0395059,
"lng": 105.7839202
},
"southwest": {
"lat": 21.0236235,
"lng": 105.7626773
}
},
"location": {
"lat": 21.0279571,
"lng": 105.771796
},
"location_type": "APPROXIMATE",
"viewport": {
"northeast": {
"lat": 21.0395059,
"lng": 105.7839202
},
"southwest": {
"lat": 21.0236235,
"lng": 105.7626773
}
}
},
"place_id": "ChIJO-fFuLpUNDERxGa6po0w8xU",
"types": [
"political",
"sublocality",
"sublocality_level_1"
],
"distance": 377.041,
"plus_code": {},
"secondary_text": "Mỹ Đình 2, Từ Liêm, Hà Nội, Việt Nam",
"sort_distance": 1000
},
{
"address_components": [
{
"long_name": "Mỹ Đình",
"short_name": "Mỹ Đình",
"types": [
"administrative_area_level_3",
"political"
]
},
{
"long_name": "Nam Từ Liêm",
"short_name": "Nam Từ Liêm",
"types": [
"administrative_area_level_2",
"political"
]
},
{
"long_name": "Hà Nội",
"short_name": "Hà Nội",
"types": [
"administrative_area_level_1",
"political"
]
},
{
"long_name": "Việt Nam",
"short_name": "VN",
"types": [
"country",
"political"
]
}
],
"formatted_address": "Mỹ Đình, Nam Từ Liêm, Hà Nội, Việt Nam",
"geometry": {
"bounds": {
"northeast": {
"lat": 21.040354,
"lng": 105.784264
},
"southwest": {
"lat": 21.014829,
"lng": 105.7538741
}
},
"location": {
"lat": 21.0234709,
"lng": 105.7732633
},
"location_type": "APPROXIMATE",
"viewport": {
"northeast": {
"lat": 21.040354,
"lng": 105.784264
},
"southwest": {
"lat": 21.014829,
"lng": 105.7538741
}
}
},
"place_id": "ChIJk362ubpUNDERP5Yp1c5q4bs",
"types": [
"administrative_area_level_3",
"political"
],
"distance": 712.902,
"plus_code": {},
"secondary_text": "Mỹ Đình, Nam Từ Liêm, Hà Nội, Việt Nam",
"sort_distance": 1000
},
{
"address_components": [
{
"long_name": "Nam Từ Liêm",
"short_name": "Nam Từ Liêm",
"types": [
"administrative_area_level_2",
"political"
]
},
{
"long_name": "Hà Nội",
"short_name": "Hà Nội",
"types": [
"administrative_area_level_1",
"political"
]
},
{
"long_name": "Việt Nam",
"short_name": "VN",
"types": [
"country",
"political"
]
}
],
"formatted_address": "Nam Từ Liêm, Hà Nội, Việt Nam",
"geometry": {
"bounds": {
"northeast": {
"lat": 21.0589091,
"lng": 105.796817
},
"southwest": {
"lat": 20.9801741,
"lng": 105.726366
}
},
"location": {
"lat": 21.0034608,
"lng": 105.7703287
},
"location_type": "APPROXIMATE",
"viewport": {
"northeast": {
"lat": 21.0589091,
"lng": 105.796817
},
"southwest": {
"lat": 20.9801741,
"lng": 105.726366
}
}
},
"place_id": "ChIJ83IOCKFUNDERl-NDjTWui7A",
"types": [
"administrative_area_level_2",
"political"
],
"distance": 2955.585,
"plus_code": {},
"secondary_text": "Nam Từ Liêm, Hà Nội, Việt Nam",
"sort_distance": 1000
},
{
"address_components": [
{
"long_name": "Hà Nội",
"short_name": "Hà Nội",
"types": [
"administrative_area_level_1",
"political"
]
},
{
"long_name": "Việt Nam",
"short_name": "VN",
"types": [
"country",
"political"
]
}
],
"formatted_address": "Hà Nội, Việt Nam",
"geometry": {
"bounds": {
"northeast": {
"lat": 21.3850271,
"lng": 106.0198859
},
"southwest": {
"lat": 20.5623231,
"lng": 105.2854659
}
},
"location": {
"lat": 21.0031177,
"lng": 105.8201408
},
"location_type": "APPROXIMATE",
"viewport": {
"northeast": {
"lat": 21.3850271,
"lng": 106.0198859
},
"southwest": {
"lat": 20.5623231,
"lng": 105.2854659
}
}
},
"place_id": "ChIJKQqAE44ANTERDbkQYkF-mAI",
"types": [
"administrative_area_level_1",
"political"
],
"distance": 5546.945,
"plus_code": {},
"secondary_text": "Hà Nội, Việt Nam",
"sort_distance": 1000
},
{
"address_components": [
{
"long_name": "Việt Nam",
"short_name": "VN",
"types": [
"country",
"political"
]
}
],
"formatted_address": "Việt Nam",
"geometry": {
"bounds": {
"northeast": {
"lat": 23.3926504,
"lng": 109.6765
},
"southwest": {
"lat": 8.1952001,
"lng": 102.1440178
}
},
"location": {
"lat": 14.058324,
"lng": 108.277199
},
"location_type": "APPROXIMATE",
"viewport": {
"northeast": {
"lat": 23.3926504,
"lng": 109.6765
},
"southwest": {
"lat": 8.1952001,
"lng": 102.1440178
}
}
},
"place_id": "ChIJXx5qc016FTERvmL-4smwO7A",
"types": [
"country",
"political"
],
"distance": 819252.776,
"plus_code": {},
"secondary_text": "Việt Nam",
"sort_distance": 1000
}
]
}
Status Codes
| Status Code | Description |
|---|---|
| 200 | OK |
| 400 | BAD REQUEST |
| 404 | NOT FOUND |
| 500 | INTERNAL SERVER ERROR |