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

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

أقلمة اللغة

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

تؤثر المعلَمة language في أسماء عناصر التحكّم وإشعارات حقوق الطبع والنشر واتجاهات القيادة وتصنيفات التحكّم، فضلاً عن الردود على طلبات الخدمة. لا يظهر التأثير في الخدمات بشكل واضح. على سبيل المثال، عندما يتم عرض ترميز البلد على مستوى الشارع، يظهر اسم البلد باللغة التي طلبتها، ولكن سيكون بقية العنوان مخصصًا للموقع الجغرافي الذي يتم ترميزه جغرافيًا. ومن ناحية أخرى، يتم عرض النتائج البريدية والسياسية باللغة المطلوبة. جرِّب هذا العرض التوضيحي لتجربة التغييرات على الخريطة عند تعديل المعلَمة language.

يعرض المثال التالي خريطة باللغة اليابانية وضبط المنطقة على اليابان:

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

عرض المثال.

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

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

وتتوافق أيضًا واجهة برمجة تطبيقات JavaScript لـ "خرائط Google" مع النص ثنائي الاتجاه (BIi) الذي يحتوي على أحرف بكل من اللغات من اليسار إلى اليمين واليمين من اليمين إلى اليسار. وتشمل الأمثلة على اللغات التي تُكتب من اليمين إلى اليسار العربية والعبرية والفارسية. وبشكل عام، يجب تحديد صفحات اللغة من اليمين إلى اليسار للعرض بشكل صحيح عن طريق إضافة السمة dir='rtl' إلى عنصر <html> في الصفحة. يوضّح المثال التالي خريطة القاهرة، مصر، باستخدام عناصر التحكّم في اللغة العربية:

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

عرض مثال

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

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

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

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

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

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

يمكنك الاطّلاع على مثال الولايات المتحدة ومثال ES.

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

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

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