أقلمة الخريطة

يمكنك تخصيص خريطتك لبلد أو منطقة معيّنة بالطرق التالية:

  • تغيير إعدادات اللغة التلقائية
  • يمكنك تحديد رمز المنطقة، الذي يغيِّر سلوك الخريطة استنادًا إلى بلد معيّن أو منطقة معيّنة.

أقلمة اللغة

بشكل تلقائي، تستخدم واجهة برمجة تطبيقات JavaScript للخرائط إعدادات اللغة المفضّلة للمستخدم كما هو محدّد في المتصفح، عند عرض معلومات نصية مثل أسماء عناصر التحكّم وإشعارات حقوق الطبع والنشر واتجاهات القيادة والتصنيفات على الخرائط. وفي معظم الحالات، من المفضّل الالتزام بإعدادات المتصفّح. وإذا كنت تريد أن تتجاهل واجهة برمجة التطبيقات JavaScript API إعداد لغة المتصفّح، يمكنك فرض عرض المعلومات بلغة معيّنة عن طريق إضافة مَعلمة language إلى العلامة <script> عند تحميل رمز 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>

الاطّلاع على مثال.

إذا ضبطت لغة الخريطة، من المهم ضبط المنطقة أيضًا. ويساعد ذلك في ضمان امتثال تطبيقك للقوانين المحلية.

ملاحظة: عند تحميل واجهة برمجة التطبيقات بالطريقة الموضّحة أعلاه، تستخدم الخريطة اللغة اليابانية لجميع المستخدمين بغض النظر عن الإعدادات المفضّلة للمستخدم. تأكَّد من أنك تريد هذا السلوك قبل ضبط هذا الخيار.

تتيح "واجهة برمجة تطبيقات JavaScript للخرائط" أيضًا استخدام النص الثنائي الاتجاه (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>

الاطّلاع على مثال

اطّلِع على قائمة اللغات المتاحة. ويُرجى العِلم بأنّه تتم غالبًا إضافة لغات جديدة، لذا قد لا تكون هذه القائمة شاملة.

أقلمة المنطقة

أضِف مَعلمة region إلى العلامة <script> عند تحميل رمز JavaScript API لـ "خرائط Google"، إذا كنت تريد تغيير تطبيقك لعرض مربّعات خرائط مختلفة أو انحياز للتطبيق (مثل انحياز نتائج الترميز الجغرافي في المنطقة).

بصفتك مطوّرًا لتطبيق واجهة برمجة تطبيقات JavaScript لـ "خرائط Google"، ننصحك دائمًا بإعداد مَعلمة region لأنّ الخدمات المختلفة (مثل الإكمال التلقائي للأماكن) تميل إلى تقديم نتائج أفضل عند ضبط region. وتقع على عاتقك أيضًا مسؤولية ضمان امتثال طلبك للقوانين المحلية من خلال ضمان تطبيق الأقلمة الصحيحة للمنطقة في البلد الذي يستضيف التطبيق.

تقبل المَعلمة region معرّفات العلامات الفرعية لمنطقة يونيكود التي توفّر (بشكل عام) عملية ربط فردية بنطاقات المستوى الأعلى التي يتم ترميزها حسب البلد (ccTLD). تتطابق معظم معرّفات مناطق يونيكود مع رموز 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&region=GB&callback=initMap">
</script>

تعرض الأمثلة التالية خريطتَين، إحداهما ترمّز المواقع الجغرافية لـ "توليدو" استنادًا إلى region تم ضبطها على US (الولايات المتحدة) على "توليدو، أوهايو" والأخرى تؤدي إلى انحياز النتائج استنادًا إلى مجموعة region تم ضبطها على ES (إسبانيا) إلى "توليدو، إسبانيا".

اطّلِع على مثال الولايات المتحدة ومثال إسبانيا.

الإصدار التجريبي للأقلمة

عند تعيين لغة الخريطة، من المهم تحديد المنطقة أيضًا. إليك عرض توضيحي يتيح لك تحميل الخريطة باختيار اللغة والمنطقة.

يمكنك مشاهدة هذا العرض التوضيحي في ملء الشاشة.