تحديد اللغة المناسبة للخريطة

يمكنك تخصيص إعدادات اللغة والمنطقة المستخدَمة في خريطتك من خلال تغيير الإعدادات التلقائية للغة ورمز المنطقة في الخريطة، ما قد يؤثر في سلوك الخريطة استنادًا إلى البلد أو المنطقة المحدّدة.

يمكنك الاطّلاع على التغطية في حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android في الـ جدول تغطية "خرائط Google".

تحديد اللغة

تستخدم حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android بشكل تلقائي إعدادات اللغة التي تم ضبطها على جهاز المستخدِم لتحديد الترجمة التي سيتم عرضها للخريطة. ومع ذلك، يمكنك إلغاء هذا السلوك التلقائي وضبط لغة معيّنة عند تهيئة الخريطة، أو تعديل اللغة والمنطقة بشكل ديناميكي بعد تهيئة الخريطة.

يؤثر ضبط اللغة في اللغة التي يتم عرض عناصر التحكّم في واجهة المستخدم وتلميحات الأدوات وإشعارات حقوق الطبع والنشر بها. تظهر التعديلات على اللغة في وقت التشغيل في عرض الخريطة، ولكن لا تظهر في أي من عناصر التحكّم الأخرى في واجهة المستخدم أو تلميحات الأدوات أو العناصر الأخرى المماثلة. ويؤثر ذلك أيضًا في ترجمة الميزات السياسية والأوصاف والميزات الطبيعية، مثل تغيير "Geneva" إلى "Genève" أو "lake" إلى "lac"، ويغيّر اتجاه عرض النص للغات التي تُكتب من اليمين إلى اليسار.

تبحث حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" الثلاثية الأبعاد لأجهزة Android عن إعدادات تحديد اللغة بالترتيب التالي. إذا لم يتم تحديد الإعدادات في الخطوة الأولى، ستواصل الحزمة البحث بالترتيب المحدّد:

1. التعديلات في وقت التشغيل: إعدادات اللغة والإعدادات المفضّلة للمنطقة التي يتم تمريرها إلى setLocale على مثيل GoogleMap3D باستخدام LocaleOptions.
2. تهيئة الخريطة: إعدادات اللغة والإعدادات المفضّلة للمنطقة المحدّدة عند إنشاء الخريطة، إما في ملف XML للتنسيق على Map3DView باستخدام السمتَين map3d:language وmap3d:region، أو بشكل آلي باستخدام Map3DInitConfig.
3. إعدادات الجهاز: اللغة التلقائية للنظام التي تم ضبطها على جهاز Android

يعرض المثال التالي خريطة باللغة الصينية ("zh") ويضبط المنطقة على الصين ("CN").

يمكنك ضبط اللغة والمنطقة في ملف XML للتنسيق باستخدام السمتَين map3d:language و map3d:region على Map3DView:

<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" />

يمكنك أيضًا تعديل اللغة والمنطقة بشكل ديناميكي في وقت التشغيل من خلال إنشاء LocaleOptions مثيل، وضبط القيم باستخدام setLanguage و setRegion، وتمريره إلى setLocale على مثيل GoogleMap3D:

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

تحديد المنطقة

يمكن أن يؤدي ضبط المنطقة باستخدام سمة XML ‏map3d:region أو السمة region على Map3DInitConfig، أو setRegion على LocaleOptions إلى عرض مربّعات خرائط مختلفة أو توجيه التطبيق نحو نتائج أكثر ملاءمة على مستوى المنطقة. بالإضافة إلى ذلك، يضمن ضبط علامة المنطقة امتثال التطبيق للقوانين المحلية من خلال تطبيق تحديد اللغة المناسب على مستوى المنطقة للبلد أو المنطقة التي يتم توزيع التطبيق فيها.