هشدار امنیتی : ما از یک مشکل امنیتی آگاه شده‌ایم که ممکن است وب‌سایت‌هایی را که از کتابخانه‌های شخص ثالث خاصی استفاده می‌کنند (از جمله polyfill.io) تحت تأثیر قرار دهد. این مشکل گاهی اوقات می‌تواند بازدیدکنندگان را بدون اطلاع یا اجازه صاحب وب‌سایت از وب‌سایت مورد نظر دور کند. بسیاری از نمونه‌های جاوا اسکریپت ما قبلاً شامل اعلان اسکریپت polyfill.io بودند. ما این را از نمونه های خود حذف کرده ایم. اگر از نمونه های جاوا اسکریپت ما که حاوی این اعلان هستند استفاده کرده اید، توصیه می کنیم اعلان را حذف کنید.

اطلاعیه : سبک نقشه پایه جدید به زودی به پلتفرم نقشه های گوگل می آید. این به‌روزرسانی برای استایل نقشه شامل یک پالت رنگی پیش‌فرض جدید، پین‌های مدرن شده و بهبودهایی در تجربه‌ها و قابلیت استفاده از نقشه است. همه سبک‌های نقشه به‌طور خودکار در مارس 2025 به‌روزرسانی می‌شوند. برای اطلاعات بیشتر در مورد در دسترس بودن و نحوه انتخاب زودتر، به سبک نقشه جدید برای پلتفرم Google Maps مراجعه کنید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

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

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

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

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

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

پارامتر 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 را به روشی که در بالا نشان داده شده بارگیری می کنید، نقشه از زبان ژاپنی برای همه کاربران صرف نظر از ترجیحات کاربر استفاده می کند. قبل از تنظیم این گزینه مطمئن شوید که این رفتار را می خواهید.

Maps JavaScript API همچنین از متن دو جهته (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 را تنظیم کنید، زیرا سرویس‌های مختلف (مانند تکمیل خودکار مکان‌ها) تمایل به ارائه نتایج بهتر در هنگام تنظیم region دارند. همچنین این مسئولیت شماست که با حصول اطمینان از اینکه بومی سازی صحیح منطقه برای کشوری که برنامه میزبانی شده است، از مطابقت برنامه شما با قوانین محلی مطابقت دارد.

پارامتر region ، شناسه‌های زیربرچسب منطقه یونیکد را می‌پذیرد که (به طور کلی) نگاشت یک به یک به دامنه‌های سطح بالای کد کشور (ccTLD) دارند. اکثر شناسه های منطقه یونیکد با کدهای آلفا-2 ISO 3166-1 یکسان هستند، با برخی استثناهای قابل توجه. برای مثال، 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 را مشاهده کنید.

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

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

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