Yêu cầu và phản hồi đối với phần mô tả địa chỉ

Phần 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ề nội dung 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 tham số extra_computations. Đưa extra_computations=ADDRESS_DESCRIPTORS vào yêu cầu mã hoá địa lý, yêu cầu mã hoá địa lý đảo ngược hoặc yêu cầu mã hoá địa lý địa điểm để nhận mã mô tả địa chỉ trong phản hồi của bạn.

Ví dụ về mã hoá địa lý

Truy vấn sau có 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ề mã hoá địa lý địa điểm

Truy vấn sau có 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ề mã hoá địa lý ngược

Truy vấn sau 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 mức độ liên quan bằng cách tính đến độ gần với toạ độ được 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ốc đó. Mỗi kết quả của mốc chứa các giá trị sau:

  • place_id là mã địa điểm của kết quả về địa danh. Xem tổng quan về mã địa điểm.
  • display_name là tên hiển thị của mốc, chứa language_code và text.
  • straight_line_distance_meters là khoảng cách từ điểm này đến điểm khác (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 người đ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ề đ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 liên kết với mốc.
    • "BESIDE" khi toạ độ đầu vào nằm ngay cạnh điểm truy cập của mốc hoặc điểm mốc.
    • "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 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 dọc theo một tuyến đường vuông góc là điểm mốc (bị hạn chế một lượt).
    • "BEHIND" khi toạ độ đầu vào gần với điểm mốc về mặt không gian, nhưng cách xa điểm truy cập.
  • types là Place types (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 ở 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à theo thứ tự từ nhỏ nhất đến lớn nhất. Mỗi kết quả areas đều chứa các giá trị sau:

  • place_id là mã địa điểm của kết quả về khu vực. Xem tổng quan về mã địa điểm.
  • display_name là tên hiển thị của khu vực, bao gồm language_code và text.
  • containment là 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ó điều nào sau đây á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 gần với cạnh của khu vực.

Phạm vi tổng hợp dữ liệu

Tính năng này chỉ có ở một số quốc gia.

Ý kiến 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.