導覽點

歐洲經濟區 (EEA) 開發人員

地理編碼回應中的 navigation_points 欄位包含點清單，可用於導覽至該地點。具體來說，在道路網路上從該地點出發或前往該地點時，這些點應做為起點或終點。每個導覽點都包含下列值：

  • location 包含導航點的經緯度值。這個地點一律非常靠近道路網路，是導航前往或離開某個地點的理想停靠或起點。該點會刻意與道路中心線稍微偏移，清楚標示地點所在的道路側。
  • restricted_travel_modes 是導航點無法使用的交通方式清單：
    • "DRIVE" 是與行車路線對應的交通方式。
    • "WALK" 是對應步行路線的交通方式。
  • road_name 包含導航點偏移的道路名稱。

對於具有精確位置的大多數地點 (例如街道地址、建築物和機構)，系統都會傳回導覽點。如果地點代表大範圍區域 (例如城市和地區)，且精確位置可能不明確，系統可能不會傳回任何導航點。

遷移通知

自 4 月 17 日起，您必須在要求中提供 NAVIGATION_POINTSextra computations 參數，才能接收導航點。客戶可以確認某些導覽點內的 road_name 欄位是否傳回，以及每個導覽點內的 location 欄位是否包含下列四個子欄位 (lat、lng、latitude、longitude)，藉此測試這項功能。

此外，您必須遷移至 location.lat 和 location.lng 欄位，而非 location.latitude 和 location.longitude 欄位。在日後的版本中，如果要求不含 NAVIGATION_POINTS 額外計算參數，回應就不會包含任何導航點，且系統不會再傳回 location.latitude 和 location.longitude 欄位。

要求詳細資料

您可以在下列類型的要求中取得導覽點：

對於上述任一要求，您都必須提供這項參數： extra_computations=NAVIGATION_POINTS。

要求範例

下列查詢使用地點地理編碼，取得美國加州 Mountain View 餐廳的導航點：

https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJZ54APTS3j4ARBYZD956MHq8&extra_computations=NAVIGATION_POINTS&key=YOUR_API_KEY

回應範例

上述查詢的回應會顯示導航點陣列：

{
  "navigation_points": [
    {
      "location": {
        "lat": 37.3940894,
        "lng": -122.0788389,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Castro Street"
    },
    {
      "location": {
        "lat": 37.394273,
        "lng": -122.0793078,
      },
      "restricted_travel_modes": ["WALK"],
      "road_name": "Wild Cherry Lane"
    },
    {
      "location": {
        "lat": 37.3941202,
        "lng": -122.0789189,
      },
      "restricted_travel_modes": ["DRIVE"]
    }
  ]
}

意見回饋

這項功能仍在實驗階段，歡迎傳送電子郵件至 geocoding-feedback-channel@google.com 提供意見。