Bộ mô tả địa chỉ sẽ trả về thông tin bổ sung cho phản hồi mã hoá địa lý ngược tiêu chuẩn giúp mô tả toạ độ vĩ độ và kinh độ bằng cách sử dụng các địa danh và khu vực. Hãy xem bản minh hoạ mã mô tả địa chỉ để khám phá API.
Yêu cầu mã hóa địa lý ngược – Thông số bổ sung
Thông số tùy chọn
Sau đây là các thông số không bắt buộc mà bạn có thể đưa vào yêu cầu mã hoá địa lý ngược:
enable_address_descriptor
– Một tham số boolean cần đi kèm với yêu cầu mã hoá địa lý đảo ngược để thêm mã mô tả địa chỉ vào phản hồi mã hoá địa lý đảo ngược tiêu chuẩn.
Ví dụ về mã hoá địa lý ngược
Truy vấn sau chứa giá trị vĩ độ/kinh độ cho một vị trí ở Deelhi:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&key=YOUR_API_KEY&enable_address_descriptor=true
Phản hồi
Truy vấn ở trên trả về một address_descriptor
bổ sung như sau:
{
"address_descriptor" : {
"areas" : [
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Turkman Gate"
},
"place_id" : "ChIJ_7LLvyb9DDkRMKKxP9YyXgs"
},
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Chandni Chowk"
},
"place_id" : "ChIJWcXciBr9DDkRUb4dCDykTwI"
},
{
"containment" : "NEAR",
"display_name" : {
"language_code" : "en",
"text" : "Katar Ganj"
},
"place_id" : "ChIJH3cWUyH9DDkRaw-9CjvcRvY"
}
],
"landmarks" : [
{
"display_name" : {
"language_code" : "en",
"text" : "Delite Cinema"
},
"straight_line_distance_meters" : 29.9306755065918,
"place_id" : "ChIJLfiYDCT9DDkROoEa7NdupUM",
"travel_distance_meters" : 418.7794799804688,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "establishment", "movie_theater", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "YES Bank"
},
"straight_line_distance_meters" : 66.83731079101562,
"place_id" : "ChIJFYHM3yb9DDkRRKGkZl2mpSQ",
"travel_distance_meters" : 489.0340270996094,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "UCO Bank"
},
"straight_line_distance_meters" : 25.38849639892578,
"place_id" : "ChIJ-c6_wCb9DDkRjIk1LeqRtGM",
"travel_distance_meters" : 403.2246398925781,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "atm", "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Delhi By Cycle Meeting Point"
},
"straight_line_distance_meters" : 44.02867126464844,
"place_id" : "ChIJNxVfkSb9DDkRJD22l-eGFdM",
"travel_distance_meters" : 97.41281890869141,
"spatial_relationship" : "AROUND_THE_CORNER",
"types" : [
"establishment",
"point_of_interest",
"tourist_attraction",
"travel_agency"
]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Axis Bank Branch"
},
"straight_line_distance_meters" : 102.3495178222656,
"place_id" : "ChIJr3uaDCT9DDkR8roHTVSn1x4",
"travel_distance_meters" : 330.8566284179688,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
}
]
},
... Results (reverse geocoding response) ...
Có hai mảng trong mỗi đối tượng address_descriptor
: landmarks
và areas
. Mảng landmarks
chứa tối đa 5 kết quả được xếp hạng theo mức độ liên quan bằng cách tính đến khoảng cách gần với toạ độ yêu cầu, mức độ phổ biến của điểm mốc và chế độ hiển thị của điểm đó. Mỗi kết quả về mốc có chứa các giá trị sau:
place_id
là mã địa điểm của kết quả điểm mốc. Hãy xem tổng quan về mã địa điểm.display_name
là tên hiển thị của điểm mốc, chứalanguage_code
vàtext
.straight_line_distance_meters
là khoảng cách từ điểm đến điểm tính bằng mét giữa toạ độ đầu vào và kết quả của điểm mốc.travel_distance_meters
là khoảng cách tính bằng mét khi di chuyển qua mạng lưới đường (bỏ qua quy định hạn chế đường) giữa toạ độ đầu vào và kết quả của điểm mốc.spatial_relationship
là mối quan hệ ước tính giữa toạ độ đầu vào và kết quả của điểm mốc:"NEAR"
là mối quan hệ mặc định khi không có điều nào sau đây áp dụng."WITHIN"
khi toạ độ đầu vào nằm trong giới hạn của cấu trúc được liên kết với điểm mốc."BESIDE"
khi toạ độ đầu vào nằm ngay cạnh điểm truy cập của điểm mốc hoặc điểm truy cập."ACROSS_THE_ROAD"
khi toạ độ đầu vào đối diện trực tiếp với điểm mốc ở phía bên kia của tuyến đường."DOWN_THE_ROAD"
khi toạ độ đầu vào nằm dọc theo cùng một tuyến với điểm mốc, nhưng không nằm dọc theo"BESIDES"
hay"ACROSS_THE_ROAD"
."AROUND_THE_CORNER"
khi toạ độ đầu vào nằm dọc theo một tuyến đường vuông góc dưới dạng điểm mốc (giới hạn ở một ngã rẽ duy nhất)."BEHIND"
khi toạ độ đầu vào nằm gần điểm truy cập về mặt không gian, nhưng cách xa điểm truy cập của điểm truy cập đó.types
là Loại địa điểm của mốc.
Đối tượng areas
chứa tối đa 3 phản hồi và tự giới hạn ở những địa điểm đại diện cho các khu vực nhỏ, chẳng hạn như các vùng lân cận, các địa phương và khu phức hợp lớn. Các vùng có chứa toạ độ yêu cầu được liệt kê trước và sắp xếp theo thứ tự từ nhỏ nhất đến lớn nhất. Mỗi kết quả areas
chứa các giá trị sau:
place_id
là mã địa điểm của kết quả tìm kiếm khu vực. Hãy xem tổng quan về mã địa điểm.display_name
là tên hiển thị của khu vực, chứalanguage_code
vàtext
.containment
là mối quan hệ vùng chứa ước tính giữa toạ độ đầu vào và kết quả khu vực:"NEAR"
là mối quan hệ mặc định khi không có điều nào sau đây áp dụng."WITHIN"
khi toạ độ đầu vào gần tâm của vùng."OUTSKIRTS"
khi toạ độ đầu vào gần với cạnh của vùng.
Phạm vi tổng hợp dữ liệu
Tính năng này chỉ hoạt động ở một số quốc gia.
Ý kiến phản hồi
Đây là tính năng thử nghiệm nên chúng tôi rất mong nhận được ý kiến phản hồi của bạn. Vui lòng gửi email cho chúng tôi theo địa chỉ address-descriptors-feedback@google.com.