Maps JavaScript API 網址參數

透過集合功能整理內容 你可以依據偏好儲存及分類內容。

本文件探討載入 Maps JavaScript API 時,您可以在指令碼載入網址的查詢字串中指定的所有參數。有些是必要參數,有些則是自選參數。依照網址標準,所有參數都會以 & 字元分隔。

下列網址範例包含所有可用參數的預留位置:

https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY
&callback=FUNCTION_NAME
&v=VERSION
&libraries="LIBRARIES"
&language="LANGUAGE"
&region="REGION"
&solution_channel="SOLUTION_IDENTIFIER"
&auth_referrer_policy="AUTH_REFERRER_POLICY"

下列 script 標記範例中的網址會載入 Maps JavaScript API:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
</script>

必要參數

載入 Maps JavaScript API 時,必須提供下列參數。

  • key:您的 API 金鑰。必須指定有效的 API 金鑰,才能載入 Maps JavaScript API。

  • callback:Maps JavaScript API 載入完成時要呼叫的全域函式名稱。

選用參數

使用這些參數來要求特定版本的 Maps JavaScript API、載入其他程式庫、本地化地圖,或指定 HTTP 參照網址檢查政策

  • v:要使用的 Maps JavaScript API 版本

  • libraries:逗號分隔的清單,包含要載入的其他 Maps JavaScript API 程式庫

  • language:要使用的語言。這會影響控制項名稱、版權聲明、行車路線和控制項標籤,以及對服務要求的回應。查看支援語言清單

  • region:要使用的區碼。這會根據特定國家/地區或地域調整地圖行為。

  • solution_channel:Google 地圖平台提供多種程式碼範例,有助您快速完成設定並開始使用。為追蹤複雜程式碼範例的採用情況,以及改善解決方案品質,Google 會在程式碼範例的 API 呼叫中加入 solution_channel 查詢參數。

  • auth_referrer_policy:Maps JS 客戶可在 Cloud 控制台中設定 HTTP 參照網址限制,以限制哪些網址可使用特定 API 金鑰。根據預設,您可以將這些限制設為僅允許特定路徑使用 API 金鑰。如果相同網域或來源的任何網址可能會使用 API 金鑰,您就可以設定 auth_referrer_policy=origin,限制在授權 Maps JavaScript API 要求時傳送的資料量。這項功能從 3.46 版開始提供。如果指定這個參數,且在 Cloud 控制台中已啟用 HTTP 參照網址限制,則只有在 HTTP 參照網址限制與目前網站網域相符 (未指定路徑) 時,才能載入 Maps JavaScript API。