Chuyển tới nội dung chính
Phiên bản: v1.1

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ộcKiểu dữ liệuMô tả
textstringĐịa chỉ muốn tra cứu có thể là đường, thành phố, v.v.
Tham số tuỳ chọnKiểu dữ liệuMô tả
typesstringLoạ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_tokenstringToken đượ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.
sizeintegerSố lượng kết quả trả về nếu không được cung cấp mặc định là 10.
region_codeintegerLọ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_codeintegerLọ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.latnumberVĩ độ của điểm cần tập trung cần tìm kiếm.
focus.point.lonnumberKinh độ của điểm cần tập trung cần tìm kiếm.

Headers

HeaderKiểu dữ liệuMô tả
app-versionstringBắ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"
}