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

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

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

أقلمة اللغة

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

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

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

تقبل مَعلمة "region" معرِّفات العلامات الفرعية لمنطقة يونيكود التي تحتوي (بشكل عام) على التعيين الفردي لنطاقات المستوى الأعلى التي يتم ترميزها حسب البلد (ccTLD). معظم يونيكود مُعرفات المناطق مُطابِقة لرموز 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>

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

عرض الولايات المتحدة المثال ES مثال

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

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

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