您可以使用地圖網址建立通用的跨平台網址,啟動 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
地圖網址:相關產品
- 常搭配使用:Places API (新版)
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。