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

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

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

أقلمة اللغة

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

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

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

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

عرض مثال

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

الأقلمة حسب المنطقة

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

بصفتك مطورًا لتطبيق واجهة برمجة تطبيقات JavaScript للخرائط، نشجعك على تعيين معلمة region دائمًا باعتبارها خدمات متنوعة (مثل الإكمال التلقائي للأماكن) تميل إلى تقديم نتائج أفضل عند تعيين 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&region=GB&callback=initMap">
</script>

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

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

عرض توضيحي حول الأقلمة

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

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