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

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

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

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

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

پارامتر 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>

مشاهده مثال.

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

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

‫Maps JavaScript API همچنین به‌طور بومی از نوشتار دوجهته (Bidi) که حاوی نویسه‌های زبان‌های چپ‌به‌راست (LTR) و راست‌به‌چپ (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>

مشاهده مثال

زبان‌های پشتیبانی‌شده

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

کد زبان زبان کد زبان زبان
af آفریکانس ja ژاپنی
sq آلبانیایی kn کنادا
am آمهاریک kk قزاقی
ar عربی km خمر
hy ارمنی ko کره‌ای
az آذربایجانی ky قرقیزی
eu باسک lo لائوسی
be Belarusian lv لتونیایی
bn بنگالی lt لیتوانیایی
bs بوسنیایی mk مقدونی
bg بلغاری ms مالایی
my برمه‌ای ml مالایالام
ca کاتالان mr ماراتی
zh چینی mn مغولی
zh-CN ‫چینی (ساده)‏ ne نپالی
zh-HK چینی (هنگ کنگ) no نروژی
zh-TW چینی (سنتی) pl لهستانی
ساعت کرواتی pt پرتغالی
cs چک pt-BR پرتغالی (برزیل)
da دانمارکی pt-PT پرتغالی (پرتغال)
nl هلندی pa پنجابی
fa انگلیسی ro رومانیایی
en-AU انگلیسی (استرالیایی) ru روسی
en-GB انگلیسی (پادشاهی متحد) sr صربی (سیریلیک)
et استونیایی sr-Latn صربی (الفبای لاتین)
fa فارسی si سینهالی
fi فنلاندی sk اسلوواک
fil فیلیپینی sl Slovenian
fr فرانسوی es اسپانیایی
fr-CA فرانسوی (کانادا) es-419 اسپانیایی (امریکای لاتین)
gl گالیسی sw سواحیلی
ka گرجستانی sv سوئدی
de آلمانی ta تامیل
el یونانی te تلوگو
gu گجراتی th تایلندی
iw عبری tr ترکی
hi هندی uk اوکراینی
hu مجارستانی ur اردو
is ایسلندی uz ازبکی
id اندونزیایی vi ویتنامی
it ایتالیایی zu زولو

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

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

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

پارامتر region شناسه‌های برچسب فرعی منطقه یونی‌کد را می‌پذیرد که (به‌طورکلی) دارای نگاشت یک‌به‌یک با دامنه‌های سطح بالای کد کشور (ccTLDs) هستند. اکثر شناسه‌های منطقه Unicode با کدهای 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 (اسپانیا) به «تولدو، اسپانیا» متمایل می‌کند.

ایالات متحده مثال و اسپانیا مثال را ببینید.

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

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

این نسخه نمایشی را در حالت تمام‌صفحه مشاهده کنید.