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

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

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

ترجمة اللغة

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

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

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

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

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

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