Haritayı Yerelleştirin

Belirli bir ülke veya bölge için haritanızı aşağıdaki şekillerde özelleştirebilirsiniz:

  • Varsayılan dil ayarlarını değiştirme
  • Belirli bir ülke veya bölgeye göre haritanın davranışını değiştiren bir bölge kodu belirtin.

Dil yerelleştirme

Varsayılan olarak Maps JavaScript API, haritalarda kontrol adları, telif hakkı bildirimleri, arabayla yol tarifleri ve etiketler gibi metinsel bilgileri görüntülerken kullanıcının tarayıcıda belirtilen tercih ettiği dil ayarını kullanır. Çoğu durumda, tarayıcı ayarına uyulması tercih edilir. Bununla birlikte, Maps JavaScript API'nin tarayıcının dil ayarını yoksaymasını istiyorsanız Maps JavaScript API kodu yüklenirken <script> etiketine language parametresi ekleyerek tarayıcının bilgileri belirli bir dilde görüntülemesini zorunlu kılabilirsiniz.

language parametresi kontrollerin, telif hakkı bildirimlerinin, arabayla yol tariflerinin ve kontrol etiketlerinin adlarının yanı sıra hizmet isteklerine verilen yanıtları etkiler. Bu durumun hizmetler üzerindeki etkisi pek belli değil. Örneğin, sokak düzeyinde coğrafi kodlama yapılan durumlarda ülke adı istediğiniz dilde döndürülür. Ancak adresin geri kalanı, coğrafi kodlamayı yaptığınız konuma özel olur. Diğer yandan, posta ve siyasi sonuçlar istenen dilde döndürülür. language parametresini güncellediğinizde haritadaki değişiklikleri denemek için bu demoyu deneyin.

Aşağıdaki örnekte Japonca bir harita gösterilmektedir ve bölgeyi Japonya olarak ayarlanmaktadır:

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

Örneği inceleyin.

Haritanın dilini ayarlarsanız bölgeyi de ayarlama seçeneğini değerlendirmek önemlidir. Bu, uygulamanızın yerel yasalara uygun olmasına yardımcı olur.

Not: API'yi yukarıda gösterildiği şekilde yüklediğinizde, haritada kullanıcı tercihlerinden bağımsız olarak tüm kullanıcılar için Japonca dil kullanılır. Bu seçeneği ayarlamadan önce bu davranışı istediğinizden emin olun.

Maps JavaScript API hem soldan sağa (LTR) hem de sağdan sola (RTL) yazılan dillerde karakter içeren çift yönlü (Bidi) metinleri de yerel olarak destekler. RTL dillerine örnek olarak Arapça, İbranice ve Farsça verilebilir. Genellikle RTL dil sayfalarının düzgün şekilde oluşturulmasını sağlamak için sayfanın <html> öğesine dir='rtl' eklemeniz gerekir. Aşağıdaki örnekte, Arapça denetimler kullanılarak Mısır, Kahire'nin bir haritası gösterilmektedir:

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

Örneği inceleyin

Desteklenen dillerin listesini inceleyin. Sık sık yeni diller eklendiği için bu listede tüm örneklere yer verilmeyebilir.

Bölge yerelleştirme

Uygulamanızı farklı harita blokları sunacak şekilde değiştirmek veya uygulamaya ağırlık vermek (ör. bölgeye göre coğrafi kodlama sonuçlarına ağırlık vermek) istiyorsanız Maps JavaScript API kodunu yüklerken <script> etiketine region parametresi ekleyin.

Çeşitli hizmetler (Yerler Otomatik Tamamlama gibi) region ayarlandığında daha iyi sonuçlar sağlama eğiliminde olduğundan, Maps JavaScript API uygulamasının geliştiricisi olarak her zaman bir region parametresi ayarlamanız önerilir. Uygulamanın barındırıldığı ülke için doğru bölge yerelleştirmesinin uygulanmasını sağlayarak uygulamanızın yerel yasalara uygun olmasını sağlamak da sizin sorumluluğunuzdadır.

region parametresi, genellikle ülke kodu Üst Düzey Alan Adlarıyla (ccTLD'ler) bire bir eşlemeye sahip olan Unicode bölge alt etiket tanımlayıcılarını kabul eder. Unicode bölge tanımlayıcılarının çoğu, bazı önemli istisnalar dışında ISO 3166-1 alfa-2 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk"dir (.co.uk alanına karşılık gelir), bölge tanımlayıcısı "GB"'dir. Desteklenen bölgeler için Google Haritalar Platformu Kapsam Ayrıntıları bölümünü inceleyin. region parametresini güncellediğinizde haritadaki değişiklikleri denemek için bu demoyu deneyin.

Örneğin, aşağıdaki komut dosyası etiketi haritayı Birleşik Krallık'a göre yerelleştirir:

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

Aşağıdaki örneklerde, biri "Toledo"nun coğrafi kodunu US (ABD) olarak "Toledo, Ohio" olarak ayarlayan ve diğeri ES (İspanya) olarak "Toledo, İspanya" olarak ayarlanmış region öğesine göre kodlayan iki harita gösterilmektedir.region

ABD örneğini ve ES örneğini görüntüleyin.

Yerelleştirme Demosu

Haritanın dilini ayarlarken, bölgenin de ayarlanmasını düşünmek önemlidir. Aşağıda, haritayı kendi dil ve bölge seçiminizle yüklemenize olanak tanıyan bir demo gösterilmektedir.

Bu demoyu tam ekranda görüntüleyin.