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®ion=JP&language=ja&callback=initMap">
</script>
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®ion=EG&language=ar&callback=initMap">
</script>
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®ion=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.