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

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

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

تكييف اللغة مع السوق المحلية

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

تؤثّر المَعلمة 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>

عرض مثال

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

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

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

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

تقبل المَعلمة region معرّفات علامات فرعية خاصة بالمناطق في Unicode التي (بشكل عام) تتضمّن ربطًا واحدًا لواحد بنطاقات المستوى الأعلى لرموز البلدان (ccTLD). تتطابق معظم معرّفات المناطق في Unicode مع رموز ISO 3166-1 alpha-2، مع بعض الاستثناءات الملحوظة. على سبيل المثال، رمز ccTLD الخاص ببريطانيا العظمى هو "uk" (المتوافق مع النطاق .co.uk)، بينما معرّف المنطقة هو "GB". يمكنك الاطّلاع على تفاصيل تغطية &quot;منصة خرائط Google&quot; لمعرفة المناطق المتاحة. جرِّب هذا العرض التوضيحي لتجربة التغييرات على الخريطة عند تعديل المَعلمة 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 (إسبانيا) ليكون "توليدو، إسبانيا".

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

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

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

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