نقشه را بومی سازی کنید

شما می‌توانید نقشه خود را برای یک کشور یا منطقه خاص به روش‌های زیر سفارشی کنید:

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

محلی‌سازی زبان

به طور پیش‌فرض، API جاوا اسکریپت Maps هنگام نمایش اطلاعات متنی مانند نام کنترل‌ها، اطلاعیه‌های حق چاپ، مسیرهای رانندگی و برچسب‌ها روی نقشه‌ها، از تنظیمات زبان ترجیحی کاربر که در مرورگر مشخص شده است، استفاده می‌کند. در بیشتر موارد، ترجیح داده می‌شود که به تنظیمات مرورگر احترام گذاشته شود. با این حال، اگر می‌خواهید API جاوا اسکریپت Maps تنظیمات زبان مرورگر را نادیده بگیرد، می‌توانید با اضافه کردن یک پارامتر language به تگ <script> هنگام بارگذاری کد API جاوا اسکریپت Maps، آن را مجبور به نمایش اطلاعات به یک زبان خاص کنید.

پارامتر language بر نام کنترل‌ها، اطلاعیه‌های حق چاپ، مسیرهای رانندگی و برچسب‌های کنترل و همچنین پاسخ به درخواست‌های خدمات تأثیر می‌گذارد. تأثیر آن بر خدمات چندان آشکار نیست. برای مثال، هنگام کدگذاری جغرافیایی آدرس‌های سطح خیابان، نام کشور به زبانی که درخواست کرده‌اید برگردانده می‌شود، اما بقیه آدرس مختص مکانی است که در حال کدگذاری جغرافیایی آن هستید. از سوی دیگر، نتایج پستی و سیاسی به زبان درخواستی برگردانده می‌شوند. برای آزمایش تغییرات روی نقشه هنگام به‌روزرسانی پارامتر language ، این نسخه آزمایشی را امتحان کنید.

مثال زیر یک نقشه به زبان ژاپنی نمایش می‌دهد و منطقه را روی ژاپن تنظیم می‌کند:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=JP&language=ja&callback=initMap">
</script>

مشاهده مثال .

اگر زبان نقشه را تنظیم می‌کنید، مهم است که منطقه را نیز در نظر بگیرید. این به شما کمک می‌کند تا اطمینان حاصل کنید که برنامه شما با قوانین محلی مطابقت دارد.

توجه: وقتی API را به روشی که در بالا نشان داده شده است بارگذاری می‌کنید، نقشه صرف نظر از تنظیمات کاربر، برای همه کاربران از زبان ژاپنی استفاده می‌کند. قبل از تنظیم این گزینه، مطمئن شوید که این رفتار را می‌خواهید.

API جاوا اسکریپت Maps همچنین از متن دو جهته (Bidi) حاوی کاراکترها در هر دو زبان چپ به راست (LTR) و راست به چپ (RTL) به صورت بومی پشتیبانی می‌کند. نمونه‌هایی از زبان‌های RTL شامل عربی، عبری و فارسی است. به طور کلی، شما باید صفحات زبان RTL را برای رندر صحیح با اضافه کردن dir='rtl' به عنصر <html> صفحه مشخص کنید. مثال زیر نقشه قاهره، مصر را با استفاده از کنترل‌های عربی رندر می‌کند:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=EG&language=ar&callback=initMap">
</script>

مشاهده مثال

فهرست زبان‌های پشتیبانی‌شده را ببینید. توجه داشته باشید که زبان‌های جدید اغلب اضافه می‌شوند، بنابراین این فهرست ممکن است جامع نباشد.

محلی سازی منطقه

اگر می‌خواهید برنامه خود را طوری تغییر دهید که کاشی‌های نقشه متفاوتی را نمایش دهد یا برنامه را بایاس کند (مانند بایاس کردن نتایج ژئوکدینگ به سمت منطقه)، هنگام بارگذاری کد API جاوا اسکریپت Maps، یک پارامتر region به تگ <script> اضافه کنید.

به عنوان توسعه‌دهنده‌ی یک برنامه‌ی Maps JavaScript API، به شما توصیه می‌شود که همیشه یک پارامتر region تنظیم کنید، زیرا سرویس‌های مختلف (مانند Places Autocomplete) معمولاً هنگام تنظیم region ، نتایج بهتری ارائه می‌دهند. همچنین مسئولیت شما این است که با اطمینان از اعمال محلی‌سازی صحیح منطقه برای کشوری که برنامه در آن میزبانی می‌شود، اطمینان حاصل کنید که برنامه‌ی شما با قوانین محلی مطابقت دارد.

پارامتر region ، شناسه‌های زیربرچسب منطقه یونیکد را می‌پذیرد که (عموماً) نگاشت یک به یک به دامنه‌های سطح بالای کد کشور (ccTLD) دارند. اکثر شناسه‌های منطقه یونیکد با کدهای ISO 3166-1 alpha-2 یکسان هستند، با برخی استثنائات قابل توجه. به عنوان مثال، ccTLD بریتانیای کبیر "uk" (مطابق با دامنه .co.uk ) است در حالی که شناسه منطقه آن "GB" است. برای مناطق پشتیبانی شده، به جزئیات پوشش پلتفرم Google Maps مراجعه کنید. برای آزمایش تغییرات روی نقشه هنگام به‌روزرسانی پارامتر region ، این نسخه آزمایشی را امتحان کنید.

برای مثال، تگ اسکریپت زیر نقشه را به بریتانیا ترجمه می‌کند:

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async&region=GB&callback=initMap">
</script>

مثال‌های زیر دو نقشه را نشان می‌دهند، یکی که کد جغرافیایی «تولدو» را بر اساس region که روی US (ایالات متحده) تنظیم شده است، روی «تولدو، اوهایو» تنظیم می‌کند و دیگری که نتایج را بر اساس region که روی ES (اسپانیا) تنظیم شده است، روی «تولدو، اسپانیا» تنظیم می‌کند.

به مثال ایالات متحده و مثال ES نگاه کنید.

نسخه آزمایشی محلی‌سازی

هنگام تنظیم زبان نقشه، مهم است که منطقه را نیز در نظر بگیرید. در اینجا یک نسخه آزمایشی وجود دارد که به شما امکان می‌دهد نقشه را با زبان و منطقه دلخواه خود بارگذاری کنید.

این دمو را به صورت تمام صفحه مشاهده کنید.