導覽點

地理編碼回應中的 navigation_points 欄位包含一組點，可用於前往該地點。具體來說，在路線網路中從或至地點規劃路線時，應將這些地點用作起點或終點。每個導航點都包含下列值：

  • location 包含導航點的經緯度值。這個位置一律會非常靠近道路網絡，並代表前往和離開某個地點時的理想停靠或起點。這個點會刻意偏離道路中線，清楚標示地點所在的道路側邊。
  • restricted_travel_modes 是導航點無法存取的交通模式清單：
    • "DRIVE" 是對應行車路線的交通模式。
    • "WALK" 是步行路線對應的交通模式。
  • road_name 包含導航點偏移的道路名稱。

系統會針對大部分具有精確位置的地點傳回導覽點，例如街道地址、建築物和設施。代表大範圍區域的地點 (例如城市和區域) 的精確位置可能會含糊不清，因此可能不會傳回任何導航點。

遷移通知

自 4 月 17 日起，您必須在要求中提供 NAVIGATION_POINTS 額外運算參數，才能收到導航點。如要測試這項功能，用戶端可以確認系統會傳回部分導覽點中的 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 與我們聯絡，提供寶貴意見。