Tài liệu API
Reverse Geocode API
Tra cứu ngược tọa độ GPS để lấy địa chỉ. Trả về tên địa điểm, địa chỉ có cấu trúc, place ID và plus code.
I. Endpoint
GET https://api.pisomap.tech/api/maps/reverse-geocodeII. Headers
| Name | Value | Required |
|---|---|---|
x-api-key | API key của bạn | Có |
III. Tham số truy vấn
| Name | Type | Required | Default | Mô tả |
|---|---|---|---|---|
lat | number | Có | — | Vĩ độ của tọa độ cần tra cứu |
lng | number | Có | — | Kinh độ của tọa độ cần tra cứu |
IV. Ví dụ
Vị trí hiện tại: Nhà hát Thành phố Hồ Chí Minh (10.77665494785082, 106.70311785181373)
curl "https://api.pisomap.tech/api/maps/reverse-geocode?lat=10.77665494785082&lng=106.70311785181373" \
-H "x-api-key: YOUR_API_KEY"Phản hồi:
{
"reveal_result": {
"place_name": "07 Công trường Lam Sơn",
"address": {
"full": "07 Công trường Lam Sơn, Sài Gòn, Hồ Chí Minh 700000, Việt Nam",
"street": "Sài Gòn",
"ward": "Hồ Chí Minh 700000",
"city": "Việt Nam"
},
"lat": 10.776612799999999,
"lng": 106.7031715,
"place_id": "0x31752f464a267e5f:0x62a0deaefa02edd7",
"plus_code": "7P28QPG3+M69"
}
}V. Các trường phản hồi
| Field | Type | Mô tả |
|---|---|---|
reveal_result | object | Phản hồi tra cứu ngược cấp cao nhất |
place_name | string | Tên địa điểm hoặc tòa nhà tại tọa độ |
address | object | Địa chỉ có cấu trúc của địa điểm |
address.full | string | Địa chỉ đầy đủ của địa điểm |
address.street | string | Đường/phố của địa điểm (từ Google Maps) |
address.ward | string | Phường/xã của địa điểm (từ Google Maps) |
address.city | string | Thành phố/quận của địa điểm (từ Google Maps) |
lat | number | Vĩ độ của địa điểm |
lng | number | Kinh độ của địa điểm |
place_id | string | ID của địa điểm trên Google Maps |
plus_code | string | Mã plus code vị trí của địa điểm |