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。