بومی‌سازی نقشه

می‌توانید تنظیمات زبان و منطقه مورداستفاده در نقشه‌تان را با تغییر دادن تنظیمات زبان پیش‌فرض و کد منطقه نقشه سفارشی‌سازی کنید. این کار می‌تواند بر رفتار نقشه براساس کشور یا قلمرو مشخص‌شده تأثیر بگذارد.

پوشش «کیت توسعه نرم‌افزار ۳ بعدی نقشه برای Android» را در جدول پوشش Maps ببینید.

بومی‌سازی زبان

به‌طور پیش‌فرض، «کیت توسعه نرم‌افزار سه‌بعدی Maps ویژه Android» از تنظیمات زبان پیکربندی‌شده در دستگاه کاربر برای تعیین اینکه کدام ترجمه نقشه نمایش داده شود استفاده می‌کند. بااین‌حال، می‌توانید این رفتار پیش‌فرض را ملغی کنید و هنگام مقداردهی اولیه نقشه، زبان خاصی تنظیم کنید، یا پس‌از مقداردهی اولیه نقشه، زبان و منطقه را به‌صورت پویا به‌روز کنید.

تنظیم زبان بر زبانی که کنترل‌های میانای کاربر، نکته‌ابزارها، و ابلاغیه‌های حق نشر به آن نمایش داده می‌شوند تأثیر می‌گذارد. به‌روزرسانی‌های محلی زمان اجرا در نمای نقشه منعکس می‌شوند، اما در هیچ‌یک از کنترل‌های میانای کاربر، نکات ابزار، یا دیگر عناصر مشابه منعکس نمی‌شوند. این تنظیم همچنین بر ترجمه ویژگی‌های سیاسی، توصیف‌گرها، و ویژگی‌های طبیعی—مثل تغییر «Geneva» به «Genève» یا «lake» به «lac»—تأثیر می‌گذارد و جهت ارائه نوشتار را برای خط‌های راست‌به‌چپ تغییر می‌دهد.

کیت توسعه نرم‌افزار Maps 3D ویژه 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 می‌تواند کاشی‌های نقشه متفاوتی ارائه دهد یا برنامه را به‌سمت نتایج مناسب‌تر منطقه‌ای متمایل کند. علاوه‌براین، تنظیم برچسب منطقه تضمین می‌کند که برنامه با اعمال بومی‌سازی منطقه‌ای صحیح برای کشور یا قلمرویی که برنامه در آن توزیع می‌شود، از قوانین محلی پیروی می‌کند.