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

Maps JavaScript API, varsayılan olarak tarayıcıda belirtilen kullanıcının tercih ettiği dil ayarını kullanarak kontrollerin adları, telif hakkı bildirimleri, yol tarifleri ve haritalardaki etiketler gibi metin bilgilerini gösterir. Ç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östermesini zorlayabilirsiniz.

language parametresi; kontrollerin adlarını, telif hakkı bildirimlerini, arabayla yol tariflerini ve kontrol etiketlerini, ayrıca 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 bu demoyu deneyin.

Aşağıdaki örnekte, Japonca bir harita gösterilmekte 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 ayarlamayı göz önünde bulundurmanız önemlidir. Bu, başvurunuzun yerel yasalara uygun olmasını sağlar.

Not: API'yi yukarıda gösterilen şekilde yüklediğinizde, kullanıcı tercihlerinden bağımsız olarak tüm kullanıcılar için haritada Japonca 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) dillerdeki karakterleri içeren çift yönlü (Bidi) metinleri 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' eklemeniz gerekir. Aşağıdaki örnekte, Arapça kontroller kullanılarak Mısır'ın Kahire şehrinin haritası 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 dillerin listesini inceleyin. Sık sık yeni diller eklendiğinden bu listenin tam kapsamlı olmayabileceğini unutmayın.

Bölgeye göre yerelleştirme

Uygulamanızı farklı harita döşemeleri sunacak şekilde değiştirmek veya uygulamayı önyargılı hale getirmek (ör. coğrafi kodlama sonuçlarını bölgeye göre önyargılı hale getirmek) istiyorsanız Maps JavaScript API kodunu yüklerken <script> etiketine bir region parametresi ekleyin.

Bir Maps JavaScript API uygulaması geliştiricisi olarak, region parametresini her zaman ayarlamanız önerilir. Çeşitli hizmetler (ör. Yerler Otomatik Tamamlama) region ayarlandığında daha iyi sonuçlar verir. 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 da sizin sorumluluğunuzdadır.

region parametresi, ülke kodu üst düzey alanlarıyla (ccTLD'ler) (genellikle) 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ı, bazı önemli istisnalar dışında ISO 3166-1 alfa-2 kodlarıyla aynıdır. Örneğin, Büyük Britanya'nın ülke kodu üst düzey alan adı "uk" (.co.uk alanına karşılık gelir), bölge tanımlayıcısı ise "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ı 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 ekran olarak görüntüleyin.