Maps 網址快速參考

您可以使用地圖網址建立通用的跨平台網址,啟動 Google 地圖來執行搜尋、規劃路線與導航、顯示地圖檢視、建立地點候選清單,或顯示街景服務全景。所有平台的網址語法都相同,且不需要 API 金鑰。

Maps URLs:重要資訊

  • 產品:Maps URLs
  • 又稱:Google 地圖網址
  • 類別:地圖
  • 平台:網址配置
  • 推出階段:GA
  • 生命週期:有效
  • 總覽:地圖網址總覽

Maps 網址:適用時機

在下列情況下使用 Google 地圖網址:

  • 您需要從 Android 應用程式、iOS 應用程式或網站取得連結,才能開啟 Google 地圖搜尋地點或顯示搜尋結果。
  • 您需要開啟 Google 地圖,並顯示兩點之間的路線,也可以選擇加入路線控點、交通方式或即時路況導航。
  • 您必須在 Google 地圖中開啟地圖檢視、地點精選清單或街景服務全景,而不使用 API 金鑰。
  • 您需要一個在 Android、iOS 和電腦版瀏覽器上運作方式相同的網址語法。

請勿在下列情況使用 Google 地圖網址:

  • 您已要求 Place Details,並想取得地點的預先格式化 Google 地圖連結 (googleMapsUri 或 googleMapsLinks 欄位)。請改用 Places API (新版)。
  • 啟動 Google 地圖應用程式時,您需要行動裝置專屬功能;請使用 Android 專用的 Google 地圖意圖,或 iOS 專用的 Google 地圖網址配置。

Maps URLs:設定

  • 使用歸因:在地圖網址中加入選用的 utm_source (應用程式名稱) 和 utm_campaign (使用者預期動作,例如 place_details_search) 查詢參數。
  • 開始使用:設定 Maps URL

Maps 網址:常見錯誤

  • 問題:query 中只有經緯度的搜尋網址會顯示圖釘,但地圖或側邊面板中不會顯示地點詳細資料。修正方式:使用 query=PLACE_NAME,ADDRESS,或在 query 旁加入 query_place_id,顯示特定地點的詳細資料。請參閱 /maps/documentation/urls/get-started。
  • 問題:地點 ID 參數 (query_place_id、origin_place_id、destination_place_id、waypoint_place_ids) 無法單獨運作。修正方式:傳遞地點 ID 參數時,一律要包含相符的基本參數 (query、origin、destination 或 waypoints)。請參閱 /maps/documentation/urls/get-started。
  • 問題:在不支援路線控點且有平台相關數量限制的 Google 地圖產品上,系統會忽略 waypoints 參數,並在無法導航時忽略 dir_action=navigate。修正方式:如果連結會在行動瀏覽器中開啟,請使用不超過三個路線控點 (否則為九個),且不要依賴 waypoints 或 dir_action=navigate 在每個 Google 地圖產品或路線上運作。請參閱 /maps/documentation/urls/get-started#directions-action。
  • 問題:地圖和街景服務共用同一個 @ 端點,因此如果地圖網址未包含正確動作,可能無法顯示地圖。修正方式:為地圖檢視設定 map_action=map,並為街景服務全景設定 map_action=pano。請參閱 /maps/documentation/urls/get-started。
  • 問題:如果地圖網址缺少 api=1,系統會忽略所有參數,並開啟 Google 地圖的預設檢視畫面。修正方式:在每個地圖網址中加入 api=1 (1 是唯一有效的值)。請參閱 /maps/documentation/urls/get-started#forming-the-url。