Haritayı yerelleştirme

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

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

Dil yerelleştirme

Varsayılan olarak, Maps JavaScript API'si, tarayıcıda belirtilen kullanıcının tercih ettiği dil ayarını, kontrollerin adları, telif hakkı bildirimleri, arabayla yol tarifleri ve haritalardaki etiketler gibi metin bilgilerini görüntülerken kullanır. Çoğu durumda tarayıcı ayarına uymak tercih edilir. Ancak Maps JavaScript API'nin tarayıcının dil ayarını yoksaymasını istiyorsanız Maps JavaScript API kodunu yüklerken language parametresini <script> etiketine ekleyerek bilgileri belirli bir dilde göstermeye zorlayabilirsiniz.

language parametresi; kontrollerin adlarını, telif hakkı bildirimlerini, arabayla yol tariflerini ve kontrol etiketlerinin yanı sıra hizmet isteklerine verilen yanıtları etkiler. Hizmetler üzerindeki etkisi o kadar belirgin değildir. Örneğin, sokak düzeyindeki adresler coğrafi olarak kodlanırken ülke adı, istediğiniz dilde döndürülür ancak adresin geri kalanı, coğrafi olarak kodladığınız konuma özgü 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 yerelleştirme demosunu deneyin.

Aşağıdaki örnekte, Japonca bir harita gösteriliyor ve bölge Japonya olarak ayarlanıyor:

<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 görüntüleyin.

Haritanın dilini ayarlarsanız bölgeyi de ayarlamayı göz önünde bulundurmanız önemlidir. Bu sayede başvurunuzun yerel yasalara uygun olduğundan emin olabilirsiniz.

Not: API'yi yukarıda gösterilen şekilde yüklediğinizde harita, kullanıcı tercihlerinden bağımsız olarak tüm kullanıcılar için Japonca dilini kullanı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 dillerdeki karakterleri içeren çift yönlü (Bidi) metni de doğal olarak destekler. Sağdan sola diller arasında Arapça, İbranice ve Farsça yer alır. Genel olarak, sağdan sola yazılan dil sayfalarının düzgün şekilde oluşturulması için sayfanın <html> öğesine dir='rtl' ekleyerek belirtmeniz gerekir. Aşağıdaki örnekte, Mısır'ın Kahire şehrinin haritası Arapça kontroller kullanılarak oluşturuluyor:

<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 görüntüleyin

Desteklenen diller

Google, desteklenen dilleri sık sık günceller. Bu liste tam kapsamlı olmayabilir ve değişebilir.

Dil Kodu Dil Dil Kodu Dil
af Afrikaanca ja Japonca
sq Arnavutça kn Kannada
öö Amharca kk Kazakça
ar Arapça km Kmerce
hy Ermenice ko Korece
az Azerice ky Kırgızca
eu Baskça lo Laoca
be Belarusian lv Letonca
bn Bengalce lt Litvanca
bs Boşnakça mk Makedonca
bg Bulgarca ms Malayca
my Burmaca ml Malayalamca
ca Katalanca mr Marathi
zh Çince mn Moğolca
zh-CN Çince (Basitleştirilmiş) ne Nepalce
zh-HK Chinese (Hong Kong) hayır Norveççe
zh-TW Çince (Geleneksel) pl Lehçe
s Hırvatça pt Portekizce
cs Çekya pt-BR Portekizce (Brezilya)
da Danca pt-PT Portekizce (Portekiz)
nl Felemenkçe pa Pencapça
en İngilizce ro Rumence
en-AU İngilizce (Avustralya) ru Rusça
en-GB İngilizce (İngiltere) sr Sırpça (Kiril)
et Estonca sr-Latn Sırpça (Latin alfabesi)
fa Farsça si Singalaca
fi Fince sk Slovakça
fil Filipince sl Slovence
fr Fransızca es İspanyolca
fr-CA Fransızca (Kanada) es-419 İspanyolca (Latin Amerika)
gl Galiçyaca sw Swahili
ka Gürcüce sv İsveççe
de Almanca ta Tamilce
el Greek te Telugu dili
gu Güceratça th Tayca
iw İbranice tr Türkçe
hi Hintçe uk Ukraynaca
hu Macarca UR Urduca
: İzlandaca uz Özbekçe
id Endonezce vi Vietnamca
it İtalyanca zu Zulu

Bölge yerelleştirme

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

Bir Maps JavaScript API'si uygulamasının geliştiricisi olarak, region parametresini her zaman ayarlamanız önerilir. Çeşitli hizmetler (ör. Yer Adı Otomatik Tamamlama) region ayarlandığında daha iyi sonuçlar verir. Uygulamanın barındırıldığı ülke için doğru bölge yerelleştirmesinin uygulandığından emin olarak uygulamanızın yerel yasalara uygun olmasını sağlamak da sizin sorumluluğunuzdadır.

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

Örneğin, aşağıdaki komut dosyası etiketi haritayı Birleşik Krallık'a 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 iki harita gösterilmektedir. Bunlardan biri, region değeri US (ABD) olarak ayarlanmış bir değere göre "Toledo"yu "Toledo, Ohio" olarak coğrafi kodlarken diğeri, region değeri ES (İspanya) olarak ayarlanmış bir değere göre sonuçları "Toledo, İspanya" olarak yönlendirir.

ABD örneğini ve İspanya örneğini inceleyin.

Yerelleştirme Demosu

Haritanın dilini ayarlarken bölgeyi de ayarlamanız önemlidir. Haritayı istediğiniz dil ve bölgeyle yüklemenize olanak tanıyan bir demoyu burada bulabilirsiniz.

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