Maps JavaScript API URL Parametreleri

Bu dokümanda, Haritalar JavaScript API'sini yüklerken komut dosyası yükleme URL'sinin sorgu dizesinde belirtebileceğiniz tüm parametreler açıklanmaktadır. Bazı parametreler gerekliyken diğerleri isteğe bağlıdır. URL'lerde olduğu gibi, tüm parametreler "ve" (&) karakteri kullanılarak ayrılır.

Aşağıdaki örnek URL'de, olası tüm parametreler için yer tutucular bulunmaktadır:

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"

Aşağıdaki script etiketindeki URL, Maps JavaScript API'yi yükler:

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

Gerekli parametreler

Maps JavaScript API yüklenirken aşağıdaki parametreler gereklidir.

  • key: API anahtarınız. Geçerli bir API anahtarı belirtilmediği sürece Maps JavaScript API yüklenmez.

  • callback: Maps JavaScript API tamamen yüklendikten sonra çağrılacak bir genel işlevin adı.

İsteğe bağlı parametreler

Maps JavaScript API'nin belirli bir sürümünü istemek, ek kitaplıklar yüklemek, haritanızı yerelleştirmek veya HTTP yönlendiren kontrolü kontrolü politikasını belirtmek için bu parametreleri kullanın

  • v: Kullanılacak Maps JavaScript API'nin sürümü.

  • libraries: Yüklenecek ek Maps JavaScript API kitaplıklarının virgülle ayrılmış listesi.

  • language: Kullanılacak dil. Bu durum kontrollerin, telif hakkı bildirimlerinin, arabayla yol tariflerinin ve denetim etiketlerinin adlarını ve hizmet isteklerine verilen yanıtları etkiler. Desteklenen dillerin listesini inceleyin.

  • region: Kullanılacak bölge kodu. Bu, belirli bir ülke veya bölgeye bağlı olarak harita davranışını değiştirir.

  • solution_channel: Google Haritalar Platformu'nun hızlıca çalışmaya başlamanıza yardımcı olacak birçok örnek kod türü vardır. Google, daha karmaşık kod örneklerimizin benimsenmesini izlemek ve çözüm kalitesini iyileştirmek için örnek kodumuzdaki API çağrılarına solution_channel sorgu parametresini ekler.

  • auth_referrer_policy: Maps JS müşterileri, belirli URL'lerin belirli bir API Anahtarı kullanmasına izin verilen URL'leri sınırlamak için Cloud Console'da HTTP Yönlendiren Kısıtlamaları'nı yapılandırabilir. Bu kısıtlamalar varsayılan olarak, yalnızca belirli yolların API Anahtarı kullanmasına izin verilecek şekilde yapılandırılabilir. Aynı alan veya kaynaktaki herhangi bir URL, API Anahtarını kullanabilirse Maps JavaScript API'den gelen istekler yetkilendirilirken gönderilen veri miktarını sınırlamak için auth_referrer_policy=origin değerini ayarlayabilirsiniz. Bu sürüm 3.46 sürümünden itibaren kullanılabilir. Bu parametre belirtildiğinde ve Cloud Console'da HTTP Yönlendiren Kısıtlamaları etkinleştirildiğinde, Maps JavaScript API yalnızca, yol belirtilmemişse geçerli web sitesinin alanıyla eşleşen HTTP Yönlendiren Kısıtlaması varsa yüklenebilir.