Haritayı Yerelleştirme

Haritanızı belirli bir ülke veya bölge için özelleştirmek için aşağıdaki yöntemleri kullanabilirsiniz:

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

Dil yerelleştirmesi

Varsayılan olarak Maps JavaScript API, haritalarda kontrol adları, telif hakkı bildirimleri, arabayla yol tarifleri ve etiketler gibi metin biçimindeki bilgileri görüntülerken tarayıcıda belirtildiği gibi kullanıcının 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 kodunu yüklerken <script> etiketine language parametresi ekleyerek, bilgileri belirli bir dilde görüntülemeye zorlayabilirsiniz.

language parametresi; kontrollerin adlarını, telif hakkı bildirimlerini, arabayla yol tariflerini ve kontrol etiketlerinin yanı sıra hizmet isteklerine verilen yanıtları etkiler. Bu durumun hizmetler üzerindeki etkisi belirgin değil. Örneğin, sokak düzeyinde adreslerin coğrafi kodlamasını yaparken ülke adı, istediğiniz dilde döndürülür ancak adresin geri kalanı, coğrafi kodlamasını yaptığınız konuma özgü olur. Diğer yandan, posta sonuçları 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örüntülenmektedir ve bölge 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 görüntüleyin.

Haritanın dilini ayarlarsanız bölgeyi de ayarlamanız önemlidir. Bu, uygulamanızın yerel yasalara uygun olmasına yardımcı olur.

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 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) dillerindeki karakterleri yerel olarak içeren çift yönlü (Bidi) metinleri de destekler. RTL dillerine örnek olarak Arapça, İbranice ve Farsça verilebilir. Genellikle, sayfanın <html> öğesine dir='rtl' ekleyerek RTL dil sayfalarının düzgün şekilde oluşturulmasını belirtmeniz gerekir. Aşağıdaki örnekte Arapça kontroller kullanılarak Kahire, Mısır haritası oluşturulmuştur:

<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 dillerin listesini inceleyin. Sık sık yeni diller eklendiğinden, bu liste tam kapsamlı olmayabilir.

Bölge yerelleştirme

Uygulamanızı farklı harita desenleri sunacak veya uygulamayı yanlılık getirecek (coğrafi kodlama sonuçlarını bölgeye göre ağırlıklandırmak gibi) istiyorsanız Maps JavaScript API kodunu yüklerken <script> etiketine bir region parametresi ekleyin.

region ayarlandığında, çeşitli hizmetler (Yerler Otomatik Tamamlama gibi) genellikle daha iyi sonuçlar verdiğinden, Maps JavaScript API uygulamasının geliştiricisi olarak her zaman bir region parametresi ayarlamanız önerilir. Uygulamanızı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 koduyla Üst Düzey Alanlar (ccTLD'ler) ile bire bir eşlemeye sahip 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" (.co.uk alanına karşılık gelir) ancak bölge tanımlayıcısı "GB"dir. Desteklenen bölgeler için Google Haritalar Platformu Kapsam Ayrıntıları'na bakın. region parametresini güncellediğinizde haritadaki değişiklikleri denemek için bu demoyu deneyin.

Örneğin, aşağıdaki komut dosyası etiketi haritayı İngiltere için 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 US (ABD), "Toledo, Ohio" olarak ayarlanmış bir region değerini temel alarak "Toledo" coğrafi kodlamasını yapan iki harita ve bir diğeri, ES (İspanya) ve "Toledo, İspanya" olarak ayarlanmış region öğesine göre sonuçlara ağırlık veren iki harita gösterilmektedir.

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

Yerelleştirme Demosu

Haritanın dilini ayarlarken, bölgeyi de ayarlamak önemlidir. Burada, haritayı dil ve bölge seçiminizle yüklemenize olanak tanıyan bir demo gösterilmektedir.

Bu demoyu tam ekran olarak görüntüleyin.