Maps JavaScript API URL Parametreleri

Koleksiyonlar ile düzeninizi koruyun İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.

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

Aşağıdaki örnek URL'de, tüm olası parametreler için yer tutucular vardı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 global işlevin adı.

İsteğe bağlı parametreler

Maps JavaScript API'nin belirli bir sürümünü istemek, ek kitaplık 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 dildir. Bu durum; kontrol adlarını, telif hakkı bildirimlerini, arabayla yol tariflerini, denetim etiketlerini ve hizmet isteklerine verilen yanıtları etkiler. Desteklenen dillerin listesine bakın.

  • region: Kullanılacak bölge kodu. Bu, haritanın davranışını belirli bir ülke veya bölgeye göre değiştirir.

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

  • auth_referrer_policy: Haritalar JS müşterileri, 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. Varsayılan olarak, bu kısıtlamalar yalnızca belirli yolların API Anahtarı kullanmasına izin verecek şekilde yapılandırılabilir. Aynı alan veya kaynaktaki herhangi bir URL, API Anahtarı'nı kullanıyorsa Haritalar JavaScript API'sinden gelen istekler yetkilendirilirken gönderilen veri miktarını sınırlandırmak için auth_referrer_policy=origin değerini ayarlayabilirsiniz. Bu sürüm 3.46 sürümünden itibaren kullanılabilir. Cloud Console'da bu parametre belirtildiğinde ve HTTP Yönlendiren Kısıtlamaları etkinleştirildiğinde, Maps JavaScript API yalnızca, yol bilgisi belirtilmemiş mevcut web sitesinin alanıyla eşleşen HTTP Yönlendiren Kısıtlaması varsa yüklenebilir.