يمكنك تخصيص خريطتك لبلد أو منطقة معيّنة بالطرق التالية:
- تغيير إعدادات اللغة التلقائية
- حدِّد رمز منطقة، ما يؤدي إلى تغيير سلوك الخريطة استنادًا إلى بلد أو منطقة محدّدة.
تكييف اللغة مع المنطقة
تستخدم 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®ion=JP&language=ja&callback=initMap">
</script>إذا ضبطت لغة الخريطة، من المهم أيضًا مراعاة ضبط المنطقة. ويساعد ذلك في ضمان امتثال تطبيقك للقوانين المحلية.
ملاحظة: عند تحميل واجهة برمجة التطبيقات بالطريقة الموضّحة أعلاه، تستخدم الخريطة اللغة اليابانية لجميع المستخدمين بغض النظر عن إعداداتهم المفضّلة. تأكَّد من أنّك تريد هذا السلوك قبل ضبط هذا الخيار.
تتيح Maps JavaScript API أيضًا استخدام النصوص ثنائية الاتجاه (Bidi) التي تحتوي على أحرف من لغات مكتوبة من اليمين إلى اليسار (RTL) ومن اليسار إلى اليمين (LTR) بشكل أصلي. تشمل أمثلة اللغات التي تتم الكتابة بها من اليمين إلى اليسار العربية والعبرية والفارسية. بشكل عام، يجب تحديد صفحات اللغة المكتوبة من اليمين إلى اليسار لكي يتم عرضها بشكل صحيح من خلال إضافة dir='rtl' إلى عنصر <html> في الصفحة. يعرض المثال التالي خريطة للقاهرة، مصر، باستخدام عناصر تحكّم باللغة العربية:
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async®ion=EG&language=ar&callback=initMap">
</script>اللغات المتاحة
تعدّل Google اللغات المتوافقة بشكل متكرّر. قد لا تكون هذه القائمة شاملة، وهي تخضع للتغيير.
| رمز اللغة | اللغة | رمز اللغة | اللغة |
|---|---|---|---|
| af | الأفريقانية | ja | اليابانية |
| sq | الألبانية | kn | الكانادا |
| am | الأمهرية | kk | الكازاخستانية |
| ar | العربية | كلم | الخميرية |
| hy | الأرمينية | ko | الكورية |
| az | أذربيجان | ky | القيرغيزية |
| eu | الباسك | lo | لاو |
| be | Belarusian | lv | اللاتفية |
| bn | البنغالية | lt | الليتوانية |
| bs | البوسنية | mk | المقدونية |
| bg | البلغارية | مللي ثانية | الماليزية |
| my | البورمية | ml | المالايالامية |
| ca | الكتالانية | mr | المراثية |
| zh | الصينية | mn | المنغولية |
| zh-CN | الصينية (المبسطة) | ne | النيبالية |
| zh-HK | Chinese (Hong Kong) | لا | النرويجية |
| zh-TW | الصينية (التقليدية) | pl | البولندية |
| ساعة | الكرواتية | pt | البرتغالية |
| cs | التشيكية | pt-BR | البرتغالية (البرازيل) |
| da | الدانماركية | pt-PT | البرتغالية (البرتغال) |
| nl | الهولندية | pa | البنجابية |
| en | الإنجليزية | ro | الرومانية |
| en-AU | الإنجليزية (الأسترالية) | ru | الروسية |
| en-GB | الإنجليزية (بريطانيا العظمى) | sr | الصربية (السيريلية) |
| et | الإستونية | sr-Latn | الصربية (نص لاتيني) |
| fa | الفارسية | si | السنهالية |
| fi | الفنلندية | sk | السلوفاكية |
| fil | الفلبينية | sl | السلوفينية |
| fr | الفرنسية | es | الإسبانية |
| fr-CA | الفرنسية (كندا) | es-419 | الإسبانية (أمريكا اللاتينية) |
| gl | الغليشيانية | sw | السواحيلية |
| ka | الجورجية | sv | السويدية |
| de | الألمانية | ta | التاميلية |
| el | اليونانية | te | التيلوغوية |
| gu | الغوجاراتية | th | التايلاندية |
| iw | العبرية | tr | التركية |
| hi | الهندية | uk | الأوكرانية |
| hu | الهنغارية | ur | الأوردية |
| هو | الأيسلندية | uz | الأوزبكية |
| id | الإندونيسية | vi | الفيتنامية |
| it | الإيطالية | zu | الزولو |
أقلمة المنطقة
أضِف المَعلمة region إلى العلامة <script> عند تحميل رمز Maps JavaScript API، إذا كنت تريد تعديل تطبيقك لعرض مربّعات خرائط مختلفة أو تحسين التطبيق (مثل تحسين نتائج الترميز الجغرافي للمنطقة).
بصفتك مطوّرًا لتطبيق يستخدم Maps JavaScript API، ننصحك دائمًا بتحديد المَعلمة region، لأنّ العديد من الخدمات (مثل ميزة "الإكمال التلقائي للأماكن" في Places API) تقدّم نتائج أفضل عند تحديد المَعلمة region.
وتقع على عاتقك أيضًا مسؤولية ضمان امتثال تطبيقك للقوانين المحلية من خلال التأكّد من تطبيق الترجمة الصحيحة للمنطقة على البلد الذي تتم فيه استضافة التطبيق.
تقبل المَعلمة region
معرّفات العلامات الفرعية الخاصة بالمناطق في Unicode التي (بشكل عام) تتضمّن ربطًا واحدًا لواحد بنطاقات المستوى الأعلى التي تتضمّن رموز بلدان (ccTLD). تتطابق معظم معرّفات المناطق في Unicode مع رموز ISO 3166-1 alpha-2، مع بعض الاستثناءات البارزة. على سبيل المثال، رمز ccTLD الخاص ببريطانيا العظمى هو "uk" (المتوافق مع النطاق .co.uk)، بينما معرّف المنطقة هو "GB". يمكنك الاطّلاع على تفاصيل التغطية في "منصة خرائط Google" لمعرفة المناطق المتاحة.
جرِّب
هذا العرض التوضيحي لتجربة التغييرات على الخريطة عند تعديل المَعلمة region.
على سبيل المثال، تعمل علامة البرنامج النصي التالية على توطين الخريطة في المملكة المتحدة:
<script async
src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&loading=async®ion=GB&callback=initMap">
</script>تعرض الأمثلة التالية خريطتَين، إحداهما ترمّز جغرافيًا "توليدو" استنادًا إلى region تم ضبطه على US (الولايات المتحدة) ليكون "توليدو، أوهايو"، والأخرى تحيّز النتائج استنادًا إلى region تم ضبطه على ES (إسبانيا) ليكون "توليدو، إسبانيا".
يمكنك الاطّلاع على مثال عن الولايات المتحدة ومثال عن إسبانيا.
عرض توضيحي للأقلمة
عند ضبط لغة الخريطة، من المهم أيضًا ضبط المنطقة. إليك عرضًا توضيحيًا يتيح لك تحميل الخريطة باللغة والمنطقة اللتين تختارهما.
يمكنك مشاهدة هذا العرض التوضيحي في وضع ملء الشاشة.