התאמה לשוק המקומי

אתם יכולים לשנות את הגדרות השפה שמוגדרות כברירת מחדל ואת קוד האזור של המפה, כדי להתאים אישית את הגדרות השפה והאזור שבהן נעשה שימוש במפה. שינוי קוד האזור יכול להשפיע על אופן הפעולה של המפה בהתאם למדינה או לטריטוריה שצוינו.

בטבלת הכיסוי של מפות Google מפורט הכיסוי של Maps 3D SDK ל-Android.

לוקליזציה של שפה

כברירת מחדל, ערכת Maps 3D SDK ל-Android משתמשת בהגדרות השפה שנקבעו במכשיר של המשתמש כדי לקבוע איזה תרגום של המפה להציג. עם זאת, אתם יכולים לשנות את התנהגות ברירת המחדל הזו ולהגדיר שפה ספציפית כשאתם מאתחלים את המפה, או לעדכן את השפה והאזור באופן דינמי אחרי שהמפה מאותחלת.

הגדרת השפה משפיעה על השפה שבה מוצגים רכיבי ממשק המשתמש, תיאורי הכלים והודעות זכויות היוצרים. עדכונים של הלוקאל בזמן הריצה משתקפים בתצוגת המפה, אבל לא ברכיבים אינטראקטיביים אחרים, בהסברים קצרים או ברכיבים אחרים כאלה. ההגדרה הזו משפיעה גם על התרגום של מאפיינים פוליטיים, תיאורים ומאפיינים טבעיים – למשל, שינוי של Geneva ל-Genève או של lake ל-lac – ומשנה את הכיוון שבו הטקסט מוצג עבור סקריפטים מימין לשמאל.

‫Maps 3D SDK ל-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)

לוקליזציה של אזור

הגדרת האזור באמצעות המאפיין map3d:region ב-XML, המאפיין region ב-Map3DInitConfig או המאפיין setRegion ב-LocaleOptions יכולה להציג משבצות מפה שונות או להטות את האפליקציה לתוצאות שמתאימות יותר לאזור. בנוסף, הגדרת תג האזור מבטיחה שהאפליקציה תעמוד בדרישות החוקים המקומיים, על ידי החלת הלוקליזציה האזורית הנכונה למדינה או לאזור שבהם האפליקציה מופצת.