Thông tin mô tả địa chỉ bao gồm thông tin bổ sung giúp mô tả một vị trí bằng cách sử dụng các địa danh và khu vực. Hãy xem bản minh hoạ về chỉ số mô tả địa chỉ để khám phá tính năng này.
Các tham số bổ sung
Bạn có thể bật chỉ số mô tả địa chỉ thông qua việc sử dụng tham số extra_computations. Thêm extra_computations=ADDRESS_DESCRIPTORS vào yêu cầu mã hoá địa lý, yêu cầu mã hoá địa lý ngược hoặc yêu cầu mã hoá địa lý địa điểm để nhận nội dung mô tả địa chỉ trong phản hồi.
Ví dụ về việc mã hoá địa lý
Truy vấn sau đây chứa địa chỉ của một địa điểm ở Delhi:
https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Ví dụ về việc mã hoá địa lý địa điểm
Truy vấn sau đây chứa mã địa điểm của một địa điểm ở Delhi:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Ví dụ về việc mã hoá địa lý ngược
Truy vấn sau đây chứa giá trị vĩ độ/kinh độ của một vị trí ở Delhi:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Phản hồi
Sau đây là ví dụ về address_descriptor:
{
"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" ]
}
]
}
}
Có 2 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 thứ tự liên quan bằng cách tính đến khoảng cách đến toạ độ được yêu cầu, mức độ phổ biến của địa danh và khả năng hiển thị của địa danh đó. Mỗi kết quả về địa điểm yêu thích đều chứa các giá trị sau:
place_idlà mã địa điểm của kết quả tìm kiếm địa danh. Xem tổng quan về mã địa điểm.display_namelà tên hiển thị của mốc, chứalanguage_codevàtext.straight_line_distance_meterslà 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ả về địa điểm.travel_distance_meterslà khoảng cách tính bằng mét khi đi qua mạng lưới đường (bỏ qua các quy định hạn chế về đường) giữa toạ độ đầu vào và kết quả về địa danh.spatial_relationshiplà mối quan hệ ước tính giữa toạ độ đầu vào và kết quả của các điểm đánh dấu:"NEAR"là mối quan hệ mặc định khi không có mối quan hệ nào sau đây được áp dụng."WITHIN"khi toạ độ đầu vào nằm trong giới hạn của cấu trúc liên kết với mốc."BESIDE"khi toạ độ đầu vào nằm ngay cạnh địa điểm yêu thích hoặc điểm truy cập của địa điểm yêu thích."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 tuyến đường."DOWN_THE_ROAD"khi toạ độ đầu vào dọc theo cùng một tuyến đường với điểm mốc, nhưng không phải là"BESIDES"hoặc"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 với điểm tham chiếu (chỉ giới hạn ở một ngã rẽ)."BEHIND"khi toạ độ đầu vào gần địa điểm đó về mặt không gian nhưng cách xa điểm truy cập của địa điểm đó.typeslà Loại địa điểm của địa danh.
Đối tượng areas chứa tối đa 3 phản hồi và tự giới hạn ở các địa điểm đại diện cho các khu vực nhỏ, chẳng hạn như vùng lân cận, các địa phương và các khu phức hợp lớn. Các khu vực chứa toạ độ được yêu cầu được liệt kê trước và được sắp xếp từ nhỏ nhất đến lớn nhất. Mỗi kết quả areas chứa các giá trị sau:
place_idlà mã địa điểm của kết quả về khu vực. Xem tổng quan về mã địa điểm.display_namelà tên hiển thị của khu vực và chứalanguage_codevàtext.containmentlà mối quan hệ ngăn chặn ước tính giữa toạ độ đầu vào và kết quả theo khu vực:"NEAR"là mối quan hệ mặc định khi không có mối quan hệ nào sau đây được áp dụng."WITHIN"khi toạ độ đầu vào gần với tâm của khu vực."OUTSKIRTS"khi toạ độ đầu vào nằm gần mép khu vực.
Phạm vi tổng hợp dữ liệu
Thông tin mô tả địa chỉ có ở tất cả các khu vực. Hãy xem phần phạm vi cung cấp theo khu vực để biết thông tin chi tiết.
Phản hồi
Đây là tính năng Xem trước và 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.