API Geocoding Reverse
Giới thiệu
Geocoding Reverse API cho phép xác định ĐỊA CHỈ từ một toạ độ nhập vào, hoặc ngược lại có thể xác định được TỌA ĐỘ từ một địa chỉ nhập vào.
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 lấy từ TOPTOP Maps |
latlng | string | Required. Tọa độ hoặc địa chỉ, ví dụ: 20.981971,105.864323 hoặc số 2 Nguyễn Hoàng |
language | string | Required. Ngôn ngữ, ví dụ: en, vi |
Request mẫu
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 |