本文件探討載入 Maps JavaScript API 時,您可以在指令碼載入網址的查詢字串中指定的所有參數。有些是必要參數,有些則是自選參數。依照網址標準,所有參數都會以 &
字元分隔。
下列網址範例包含所有可用參數的預留位置:
https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY
&callback=FUNCTION_NAME
&v=VERSION
&libraries="LIBRARIES"
&language="LANGUAGE"
®ion="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。