Haritayı yerelleştirme

Haritanızı belirli bir ülke veya bölge için aşağıdaki yöntemlerle ö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ştirmesi

Haritalar JavaScript API, varsayılan olarak haritalardaki denetim adları, telif hakkı bildirimleri, sürüş talimatları ve etiketler gibi metin bilgilerini görüntülerken tarayıcıda belirtildiği şekilde kullanıcının tercih ettiği dil ayarını kullanır. Çoğu durumda, tarayıcı ayarına uyulması tercih edilir. Ancak, Maps JavaScript API'nin tarayıcının dil ayarını yoksamasını istiyorsanız Maps JavaScript API kodunu yüklerken <script> etiketine bir language parametresi ekleyerek bilgileri belirli bir dilde göstermeye zorlayabilirsiniz.

language parametresi, kontrollerin adlarını, telif hakkı bildirimlerini, sürüş yönergelerini ve kontrol etiketlerinin yanı sıra hizmet isteklerine verilen yanıtları etkiler. Hizmetler üzerindeki etkisi o kadar belirgin değildir. Örneğin, cadde düzeyindeki adresler coğrafi kodlandığında ülke adı istediğiniz dilde döndürülür ancak adresin geri kalanı, coğrafi 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 haritada yapılan 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 inceleyin.

Haritanın dilini ayarlarken bölgeyi de ayarlamanız önemlidir. Bu, uygulamanızın yerel yasalara uygun olmasını sağlar.

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) dillerde karakterler içeren iki yönlü (Bidi) metinleri de doğal olarak destekler. Arapça, İbranice ve Farsça, sağdan sola doğru yazılan diller arasındadır. Genellikle, sayfanın <html> öğesine dir='rtl' ekleyerek sağdan sola doğru yazılan dil sayfalarının düzgün şekilde oluşturulmasını belirtmeniz gerekir. Aşağıdaki örnekte, Arapça kontroller kullanılarak Mısır'ın Kahire şehrinin 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 listede yer almayan diller de olabilir.

Bölge yerelleştirmesi

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

Bir Maps JavaScript API uygulamasının geliştiricisi olarak, çeşitli hizmetler (ör. Places Otomatik Tamamlama) region ayarlandığında daha iyi sonuçlar sağladığı için her zaman bir region parametresi belirlemeniz önerilir. Ayrıca, 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 alanlarıyla (ccTLD'ler) bire bir eşlenen Unicode bölge alt etiketi tanımlayıcılarını kabul eder. Unicode bölge tanımlayıcıların çoğu, bazı önemli istisnalar dışında ISO 3166-1 alpha-2 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" iken (.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ı'na 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 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 US (ABD) olarak ayarlanmış bir region'ye göre "Toledo"yu "Toledo, Ohio" olarak coğrafi kodlayan, diğeri ise ES (İspanya) olarak ayarlanmış bir region'ye göre sonuçları "Toledo, İspanya" olarak yanlı gösteren iki harita gösterilmektedir.

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

Yerelleştirme Demosu

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

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