Forward Geocoding
API Forward Geocoding GTEL MAPS cho phép tìm kiếm một địa điểm bằng chuỗi văn bản và trả về địa chỉ được chuẩn hóa, ngữ cảnh địa lý và tọa độ của địa điểm đó.
Dịch vụ Forward Geocoding
Loading...
Tham số
| Tham số bắt buộc | Kiểu dữ liệu | Mô tả |
|---|---|---|
text | string | Địa chỉ muốn tra cứu có thể là đường, thành phố, v.v. |
| Tham số tuỳ chọn | Kiểu dữ liệu | Mô tả |
|---|---|---|
types | string | Loại địa điểm cần tìm kiếm có thể là một hoặc nhiều loại, phân cách bằng dấu phẩy. Ví dụ: hospital,restaurant. Địa điểm phổ biến: - accident_blackspot: Điểm đen tai nạn. - airport: Sân bay. - amusement_park: Công viên giải trí. - bank: Ngân hàng. - cafe: Quán cà phê. - charging_station: Trạm sạc. - church: Nhà thờ. - clinic: Phòng khám. - college: Trường cao đẳng. - company: Công ty. - convention_center: Trung tâm hội nghị. - event_planner: Nhà tổ chức sự kiện. - fire_station: Trạm cứu hỏa. - fitness: Trung tâm thể dục. - gas_station: Trạm xăng. - government_office: Cơ quan chính phủ. - gym: Phòng gym. - hospital: Bệnh viện. - hotel: Khách sạn. - insurance_agency: Đại lý bảo hiểm. - landmark: Địa danh. - market: Chợ. - medical_center: Trung tâm y tế. - medical_station: Trạm y tế. - museum: Bảo tàng. - national_park: Vườn quốc gia. - park: Công viên. - police: Cơ quan công an. - post_office: Bưu điện. - restaurant: Nhà hàng. - roadside_assistance: Hỗ trợ bên đường. - sports_field: Sân thể thao. - store: Cửa hàng. - toll_booth: Trạm thu phí. - traffic_camera: Camera giao thông. - traffic_police: Cảnh sát giao thông. - university: Đại học. - vehicle_inspection: Trạm đăng kiểm. |
next_page_token | string | Token được sử dụng để gọi tải thêm (load more) khi phân trang cho các lần gửi yêu cầu tiếp theo.Token cho trang tiếp theo sẽ được trả về tại meta.pagination.next_page_token. |
size | integer | Số lượng kết quả trả về nếu không được cung cấp mặc định là 10. |
region_code | integer | Lọc kết quả theo mã tỉnh/thành phố. Chỉ trả về địa chỉ thuộc tỉnh/thành phố có mã này. Xem danh sách mã tại đây. |
localadmin_code | integer | Lọc kết quả theo mã xã/phường. Chỉ trả về địa chỉ thuộc xã/phường có mã này. Xem danh sách mã tại đây. |
focus.point.lat | number | Vĩ độ của điểm cần tập trung cần tìm kiếm. |
focus.point.lon | number | Kinh độ của điểm cần tập trung cần tìm kiếm. |
Headers
| Header | Kiểu dữ liệu | Mô tả |
|---|---|---|
app-version | string | Bắt buộc. Phiên bản API: 1.1 |
Yêu cầu và phản hồi mẫu: Dịch vụ Forward Geocoding
Loading API request...
{
"geocoding": {
"query": {
"text": "47A Phạm Viết Chánh",
"size": 1,
"layers": ["address", "poi"],
"sources": ["gm"],
"private": false,
"lang": {
"name": "Vietnamese",
"iso6391": "vi",
"iso6393": "vie",
"via": "querystring",
"defaulted": false
},
"querySize": 20,
"parser": "pelias",
"parsed_text": {
"subject": "47A Phạm Viết Chánh"
}
}
},
"type": "FeatureCollection",
"features": [
{
"type": "Feature",
"geometry": {
"type": "Point",
"coordinates": [106.683231, 10.766141]
},
"properties": {
"id": "43d487ae-0218-4c3f-aaa2-cec161ede1a5",
"gid": "gm:address:43d487ae-0218-4c3f-aaa2-cec161ede1a5",
"layer": "address",
"source": "gm",
"source_id": "43d487ae-0218-4c3f-aaa2-cec161ede1a5",
"name": "Công Ty Cổ Phần Viễn Thông Di Động Toàn Cầu (Gtel Mobile Jsc.)",
"confidence": 1,
"match_type": "exact",
"accuracy": "point",
"country": "Việt Nam",
"region": "Thành phố Hồ Chí Minh",
"localadmin": "Cầu Ông Lãnh",
"plus_code": "7P28QM8M+F7",
"region_code": "79",
"localadmin_code": "26758",
"locality_code": "26758",
"address": "47A Phạm Viết Chánh, Phường Cầu Ông Lãnh, Thành phố Hồ Chí Minh, Việt Nam",
"types": ["street_address"],
"address_components": [
{
"longText": "47A",
"shortText": "47A",
"types": ["street_number"]
},
{
"longText": "Phạm Viết Chánh",
"shortText": "Phạm Viết Chánh",
"types": ["route"]
},
{
"longText": "Phường Cầu Ông Lãnh",
"shortText": "Cầu Ông Lãnh",
"adminCode": "26758",
"adminLevel": "Phường",
"types": ["administrative_area_level_3"]
},
{
"longText": "Thành phố Hồ Chí Minh",
"shortText": "Hồ Chí Minh",
"adminCode": "79",
"adminLevel": "Thành phố Trung ương",
"types": ["administrative_area_level_1"]
},
{
"longText": "",
"shortText": "",
"types": ["postal_code"]
},
{
"longText": "Việt Nam",
"shortText": "VN",
"types": ["country"]
}
]
}
}
],
"bbox": [106.683231, 10.766141, 106.683231, 10.766141],
"meta": {
"pagination": {
"next_page_token": "WzYwLjAyODY0NSwiNDNkNDg3YWUtMDIxOC00YzNmLWFhYTItY2VjMTYxZWRlMWE1Il0="
}
},
"licence": "GTEL MAPS"
}