Haritayı yerelleştirme

Varsayılan dil ayarlarını ve haritanın bölge kodunu değiştirerek haritanızda kullanılan dil ve bölge ayarlarını özelleştirebilirsiniz. Bu, haritanın davranışını belirtilen ülke veya bölgeye göre etkileyebilir.

Android için Haritalar 3D SDK'sının kapsamını Haritalar kapsam tablosunda görebilirsiniz.

Dil yerelleştirmesi

Android için Maps 3D SDK, haritanın hangi çevirisinin gösterileceğini belirlemek için varsayılan olarak kullanıcının cihazında yapılandırılan dil ayarlarını kullanır. Ancak bu varsayılan davranışı geçersiz kılabilir ve haritayı başlatırken belirli bir dil ayarlayabilir veya harita başlatıldıktan sonra dili ve bölgeyi dinamik olarak güncelleyebilirsiniz.

Dil ayarı, kullanıcı arayüzü kontrollerinin, ipuçlarının ve telif hakkı bildirimlerinin gösterildiği dili etkiler. Çalışma zamanı yerel ayar güncellemeleri harita görünümüne yansıtılır ancak diğer kullanıcı arayüzü kontrolleri, ipuçları veya benzer öğelere yansıtılmaz. Ayrıca siyasi özelliklerin, tanımlayıcıların ve doğal özelliklerin (ör. "Geneva"yı "Genève"ye veya "lake"i "lac"a dönüştürme) çevirisini de etkiler ve sağdan sola yazılan metinlerin oluşturulma yönünü değiştirir.

Android için Haritalar 3D SDK'sı, yerelleştirme tercihlerini aşağıdaki sırayla arar. Tercihler ilk adımda tanımlanmamışsa belirtilen sırayla aranmaya devam edilir:

  1. Çalışma zamanı güncellemeleri: Dil ve bölge tercihleri, LocaleOptions kullanılarak GoogleMap3D örneğinizde setLocale'e aktarılır.
  2. Harita başlatma: Harita oluşturulurken belirtilen dil ve bölge tercihleri. Bu tercihler, Map3DView üzerindeki düzen XML'nizde map3d:language ve map3d:region özellikleri kullanılarak ya da Map3DInitConfig kullanılarak programatik olarak belirtilir.
  3. Cihaz ayarları: Android cihazda yapılandırılan sistem varsayılan yerel ayarı.

Aşağıdaki örnekte, Çince ("zh") bir harita gösterilmekte ve bölge Çin ("CN") olarak ayarlanmaktadır.

Map3DView öğesindeki map3d:language ve map3d:region özelliklerini kullanarak düzen XML dosyanızda dili ve bölgeyi yapılandırabilirsiniz:

<com.google.android.gms.maps3d.Map3DView
    android:id="@+id/map3dView"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    map3d:mapMode="hybrid"
    map3d:language="zh"
    map3d:region="CN" />

Ayrıca, çalışma zamanında dil ve bölgeyi dinamik olarak da güncelleyebilirsiniz. Bunun için bir LocaleOptions örneği oluşturup değerleri setLanguage ve setRegion ile ayarlayarak setLocale üzerinden GoogleMap3D örneğinize iletmeniz gerekir:

val localeOptions = LocaleOptions().apply {
    language = "zh"
    region = "CN"
}
googleMap3D.setLocale(localeOptions)

Bölge yerelleştirme

Bölgeyi map3d:region XML özelliği, region Map3DInitConfig, veya setRegion LocaleOptions kullanarak ayarlamak farklı harita döşemelerinin sunulmasına veya uygulamanın daha bölgesel olarak uygun sonuçlara yönlendirilmesine neden olabilir. Ayrıca bölge etiketinin ayarlanması, uygulamanın dağıtıldığı ülke veya bölge için doğru bölgesel yerelleştirmeyi uygulayarak uygulamanın yerel yasalara uymasını sağlar.