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

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

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

الأقلمة للّغة

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

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

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

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

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

العرض التوضيحي للترجمة

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

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