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ştirin.
  • Haritanın davranışını belirli bir ülke veya bölgeye göre değiştiren bir bölge kodu belirtin.

Dil yerelleştirme

Varsayılan olarak Maps JavaScript API, Haritalar'da kullanıcının tercih ettiği dil ayarını kullanarak kontrollerin adları, telif hakkı bildirimleri, arabayla yol tarifleri ve haritalardaki etiketler gibi metin bilgilerini gösterir. Çoğu durumda, tarayıcı ayarına saygı duyulması tercih edilir. Ancak Haritalar JavaScript API'sinin tarayıcının dil ayarını yoksaymasını istiyorsanız Haritalar JavaScript API'si kodunu yüklerken <script> etiketine bir language parametresi ekleyerek API'yi belirli bir dilde bilgi göstermeye zorlayabilirsiniz.

language parametresi; kontrol adlarını, telif hakkı bildirimlerini, arabayla yol tariflerini, kontrol etiketlerini ve hizmet isteklerine verilen yanıtları etkiler. Bu durumun hizmetler üzerindeki etkisi belirgin değildir. Örneğin, sokak düzeyinde coğrafi kodlama için ülke adı, istediğiniz dilde döndürülür ancak adresin geri kalanı coğrafi kodlama yaptığınız konuma özel olur. Öte yandan, posta ve siyasi sonuçlar istenilen dilde döndürülür. language parametresini güncellediğinizde haritada yapılan değişiklikleri denemek için bu demoyu deneyin.

Aşağıdaki örnekte Japonca bir harita görüntülenmektedir ve bölge Japonya'ya ayarlıdır:

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

Örneği görüntüleyin.

Haritanın dilini ayarlarsanız bölgeyi de ayarlamak önemlidir. Bu, uygulamanızın yerel yasalara uygun olmasını sağlamaya 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 dili kullanır. Bu seçeneği belirlemeden önce bu davranışı istediğinizden emin olun.

Maps JavaScript API, ayrıca yerel olarak soldan sağa (LTR) ve sağdan sola (RTL) dillerdeki karakterleri içeren çift yönlü (Bidi) metinleri de destekler. RTL dillerine örnek olarak Arapça, İbranice ve Farsça verilebilir. Genel olarak, sayfanın <html> öğesine dir='rtl' ekleyerek doğru şekilde oluşturulacak RTL dil sayfalarını belirtmeniz gerekir. Aşağıdaki örnekte Arapça kontroller kullanılarak Kahire, Mısır'ın bir haritası gösterilmektedir:

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

Örneği göster

Desteklenen dillerin listesine bakın. Sık sık yeni diller eklendiğini, bu nedenle bu listenin tam kapsamlı olmadığını unutmayın.

Bölge yerelleştirme

Haritalar JavaScript API'si kodunu yüklerken <script> etiketine bir region parametresi ekleyin. Bunun için uygulamanızı farklı harita döşemeleri sunmak veya uygulamaya ağırlık vermek (ör. coğrafi kodlama sonuçlarına bölgeye ağırlık vermek) gerekir.

Bir Maps JavaScript API uygulamasının geliştiricisi olarak, region etkinleştirildiğinde her zaman çeşitli hizmetlerin (Yerler Otomatik Tamamlama gibi) daha iyi sonuçlar sağlayacağından bir region parametresini ayarlamanız önerilir. Ayrıca, 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 sizin sorumluluğunuzdadır.

region parametresi, ülke kodu En Üst Düzey Alanlarla (ccTLD) bire bir eşlemesi olan Unicode bölge alt etiketi tanımlayıcılarını kabul eder. Unicode bölge tanımlayıcılarının çoğu, ISO 3166-1 alfa-2 kodlarıyla aynıdır ancak bazı önemli istisnalar söz konusudur. Örneğin, Büyük Britanya'nın ccTLD'si "uk&quot (.co.uk alanına karşılık gelir) ve bölge tanımlayıcısı &&tt;GB'dir. Desteklenen bölgeler için Google Haritalar Platformu Kapsam Ayrıntıları konusuna bakın. region parametresini güncellediğinizde haritada yapılan değişiklikleri denemek için bu demoyu 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&region=GB&callback=initMap">
</script>

Aşağıdaki örneklerde, biri "Toledo, Ohio" olarak US (ABD) olarak ayarlanmış bir region coğrafi temeli, diğeri de "Toledo, İspanya" olarak region ayarlanmış bir region

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

Yerelleştirme Demosu

Haritanın dilini ayarlarken, bölgeyi de ayarlamayı göz önünde bulundurmak ö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.