استخدام أرقام تعريف الخرائط

معرّف الخريطة هو معرّف فريد يُستخدَم لتمثيل نسخة واحدة من "خرائط Google". يمكنك استخدام أرقام تعريف الخرائط لتفعيل الميزات أو إدارة الخرائط أو تصميمها على مواقعك الإلكترونية وفي تطبيقاتك. يمكنك إنشاء معرّفات خرائط لكل منصة تحتاج إليها، مثل JavaScript أو Android أو iOS أو "الخرائط الثابتة"، في مشروعك على Google Cloud Console ضمن صفحة إدارة الخرائط.

الإجراءات التي يمكنك اتّخاذها باستخدام أرقام تعريف الخرائط

استخدِم أرقام تعريف الخرائط لتفعيل الميزات والتصميم. في ما يلي بعض الأمثلة على كيفية استخدام أرقام تعريف الخرائط. للحصول على قائمة كاملة، اطّلِع على العناصر التي تستخدِم أرقام تعريف الخرائط:

  • تصميم الخرائط المستندة إلى السحابة الإلكترونية: يمكنك ربط معرّف خريطة بأسلوب خريطة لتحديد أسلوب خرائطك وخصيصها وإدارتها باستخدام Google Cloud Console. تتوفّر على جميع المنصّات: JavaScript، Android، iOS، وMaps Static API.

  • الخرائط الاتجاهية: استخدِم رقم تعريف خريطة لاستخدام خريطة تتألف من شرائح مستندة إلى اتجاهات يتم رسمها في وقت التحميل على جانب العميل باستخدام WebGL. متاح في JavaScript.

  • محدّدات المواقع المتقدّمة: استخدِم رقم تعريف خريطة لتفعيل "محدّدات المواقع المتقدّمة". يتوفّر على JavaScript و Android و iOS.

مثال على تصميم الخرائط المستندة إلى السحابة الإلكترونية

لاستخدام ميزة "تصميم الخرائط" المستندة إلى السحابة الإلكترونية لتصميم الخرائط على موقعك الإلكتروني وتطبيقات Android، اتّبِع الخطوات التالية:

  1. أنشئ أرقام تعريف الخرائط لكل منصة تستخدمها. على سبيل المثال، أنشئ ملف JavaScript ومعرّف خريطة Android. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة إنشاء أرقام تعريف الخرائط.

  2. ضبط نمط خريطة في Google Cloud Console لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة تصميم الخرائط المستنِد إلى السحابة الإلكترونية.

  3. اربط معرّفَي الخريطتَين بأسلوب الخريطة في Google Cloud Console. لمعرفة التفاصيل، يُرجى الاطّلاع على مقالة ربط أرقام تعريف الخرائط بأسلوبك.

  4. يمكنك الإشارة إلى معرّف الخريطة في رمز JavaScript لموقعك الإلكتروني وفي رمز تطبيق Android. لمعرفة التفاصيل، يُرجى الاطّلاع على إضافة رقم تعريف خريطة إلى تطبيقك.

بعد ذلك، يتم عرض نمط الخريطة المرتبط بأرقام تعريف الخرائط على موقعك الإلكتروني وفي تطبيق Android. ويمكنك إجراء تعديلات على نمط الخريطة في Cloud Console، وستظهر التغييرات في كلا المكانَين تلقائيًا، بدون الحاجة إلى أن يُجري عملاؤك أي تعديلات على التطبيق.

الميزات التي تستخدم أرقام تعريف الخرائط

يعرض الجدول التالي ميزات "منصة خرائط Google" وواجهات برمجة التطبيقات التي تستخدم أرقام تعريف الخرائط:

الميزة أو واجهة برمجة التطبيقات استخدام أرقام تعريف الخرائط لتحقيق هذه الأهداف
العلامات المتقدّمة فعِّل العلامات المتقدّمة. لست بحاجة إلى إنشاء معرّف خريطة، ويمكنك بدلاً من ذلك استخدام معرّف الخريطة التجريبية `DEMO_MAP_ID`.
التصميم المستنِد إلى البيانات للحدود اربط رقم تعريف الخريطة بمجموعة من الحدود والتصميمات لتحديد أسلوب الخريطة وفقًا للحدود.
تصميم مستند إلى البيانات لمجموعات البيانات اربط رقم تعريف الخريطة بمجموعة من البيانات والتنسيقات لتنسيق الخريطة وفقًا لمجموعة البيانات.
Flutter يمكنك تصميم خرائط Google المستخدَمة في تطبيقاتك المكتوبة باستخدام Flutter.
Maps Embed API حدِّد الخريطة ونمطها لتضمينها في صفحة ويب.
واجهة برمجة تطبيقات JavaScript في خرائط Google اضبط نمط الخريطة لعرضها على صفحة ويب.
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android أنشئ نمطًا للخريطة ليتم عرضها في تطبيق Android.1
حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات iOS أنشئ نمطًا للخريطة ليتم عرضها في تطبيق iOS.1
Maps Static API حدِّد الخريطة وأنمِّطها لعرضها كصورة ثابتة.
حلول التنقّل استخدِم واجهة برمجة التطبيقات JavaScript API لحزمة "خرائط Google" وحِزم تطوير البرامج (SDK) لنظامَي التشغيل Android وiOS لتنسيق الخرائط في حلول "التنقّل".1
WebGL (الخرائط المتجهّة) فعِّل ميزات WebGL باستخدام معرّف خريطة اتجاهية في JavaScript.

1 يؤدي استخدام رقم تعريف خريطة في حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android أو حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل iOS إلى تحميل خريطة يتم تحصيل رسومها من خلال رمز التخزين التعريفي للخرائط الديناميكية.

كيفية إنشاء أرقام تعريف الخرائط واستخدامها

معرّف الخريطة هو معرّف فريد يمثّل نسخة واحدة من خريطة Google. يمكنك إنشاء معرّفات خرائط وتعديل نمط الخريطة المرتبط بمعرّف خريطة في وحدة تحكّم Cloud.

الأذونات المطلوبة

لإنشاء أي معرّفات خرائط في مشروعك أو إدارتها، عليك استخدام مبدأ أساسي يمتلك الأذونات المناسبة على مستوى الدور، سواء "محرِّر" أو "مالك"، في صفحة "إدارة الهوية وإمكانية الوصول" في Cloud Console للمشروع. للاطّلاع على التفاصيل، يُرجى الاطّلاع على مرجع الأدوار الأساسية والمحدّدة مسبقًا لإدارة الهوية وإمكانية الوصول.

إنشاء أرقام تعريف الخرائط

يمكنك إنشاء معرّفات خرائط وتعديل نمط مرتبط بمعرّف خريطة في أي وقت في Cloud Console.

لإنشاء معرّف خريطة، اتّبِع الخطوات التالية:

  1. سجِّل الدخول إلى مشروع على Cloud Console وافتحه باستخدام الأذونات المطلوبة.

  2. في Cloud Console، انتقِل إلى صفحة "إدارة خرائط Google".

  3. انقر على إنشاء معرّف خريطة.

    إنشاء معرّف خريطة جديد

  4. في صفحة إنشاء رقم تعريف خريطة جديد، اتّبِع الخطوات التالية:

    1. في الحقل الاسم، أدخِل اسمًا لرقم تعريف الخريطة.
    2. اختياري: بالنسبة إلى الوصف، يمكنك وصف الغرض من استخدام رقم تعريف الخريطة.
    3. بالنسبة إلى نوع الخريطة، اختَر المنصة التي تخطِّط لاستخدام رقم تعريف الخريطة عليها. إذا اخترت JavaScript، اختَر أيضًا نوع خريطة Raster (التلقائي) أو Vector. لمزيد من المعلومات عن الخرائط المستندة إلى رسومات هندسية، يُرجى الاطّلاع على مقالة الخرائط المستندة إلى رسومات هندسية.
    4. انقر على حفظ لعرض رقم تعريف الخريطة الجديد.

ربط رقم تعريف خريطة بأسلوب خريطة

تفترض هذه التعليمات توفّر نمط خريطة واحد على الأقل في مشروعك. إذا لم يكن لديك أي أنماط خرائط، اطّلِع على أنماط الخرائط المستندة إلى السحابة الإلكترونية واختَر منصّتك للحصول على تعليمات حول كيفية إنشاء نمط.

  1. في Cloud Console، انتقِل إلى صفحة "إدارة خرائط Google".
  2. من الجدول، اختَر معرّف خريطة حاليًا.
  3. ضمن نمط الخريطة المرتبط، اختَر نمط خريطة.

  4. انقر على حفظ.

    صفحة التفاصيل لرقم تعريف خريطة، حيث يمكنك ربط نمط خريطة

إضافة معرّف الخريطة إلى تطبيقك

Android

أضِف رقم تعريف الخريطة من خلال عنصر <fragment> في ملف تنسيق النشاط، باستخدام فئة MapView، أو برمجيًا باستخدام فئة GoogleMapOptions.

على سبيل المثال، لنفترض أنّك أنشأت معرّف خريطة تم تخزينه كقيمة سلسلة باسم map_id في res/values/strings.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">MAP_ID</string>
</resources>

بالنسبة إلى الخرائط التي تمت إضافتها من خلال عنصر <fragment> في ملف تنسيق النشاط، يجب أن تحدِّد جميع أجزاء الخريطة التي يجب أن تتضمّن النمط المخصّص رقم تعريف الخريطة في السمة map:mapId:

<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
    map:name="com.google.android.gms.maps.SupportMapFragment"
    …
    map:mapId="@string/map_id" />

يمكنك أيضًا استخدام سمة map:mapId لفئة MapView لتحديد معرّف خريطة:

<com.google.android.gms.maps.MapView
    xmlns:android="http://schemas.android.com/apk/res/android"
    ....
    map:mapId="@string/map_id" />

لتحديد رقم تعريف خريطة آليًا، يجب تمريره إلى مثيل MapFragment باستخدام فئة GoogleMapOptions:

Java

 MapFragment mapFragment = MapFragment.newInstance(
     new GoogleMapOptions()
         .mapId(getResources().getString(R.string.map_id)));

Kotlin

 val mapFragment = MapFragment.newInstance(
     GoogleMapOptions()
         .mapId(resources.getString(R.string.map_id))
 )

في "استوديو Android"، أنشئ تطبيقك وشغِّله كالمعتاد. يتم تطبيق الأنماط المخصّصة التي تم ضبطها في الخطوة الأولى على جميع الخرائط التي تحتوي على رقم تعريف الخريطة المحدّد.

iOS

لإنشاء مثيل لخريطة باستخدام رقم تعريف الخريطة، اتّبِع الخطوات التالية:

  1. أنشئ GMSMapID باستخدام سلسلة معرّف الخريطة من Cloud Console.
  2. أنشئ GMSMapView يحدِّد رقم تعريف الخريطة الذي أنشأته للتو.

Swift

let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "MAP_ID")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)
self.view = mapView

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169
                                                        longitude:-122.336471
                                                             zoom:12];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"MAP_ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;

إذا كنت تستخدم معرّف الخريطة الخاص بك، يمكنك ضبط معرّف الخريطة في Cloud Console للحصول على أسلوب جديد في أي وقت، وسيظهر هذا الأسلوب في عرض الخريطة تلقائيًا لك وللمستخدمين في غضون ست ساعات تقريبًا.

إذا كنت تريد الاطّلاع على التغييرات على الفور، يمكنك إغلاق تطبيقك وإعادة تشغيله من خلال الخروج من التطبيق وإغلاقه من قائمة التطبيقات التي تم استخدامها مؤخرًا، ثم إعادة فتحه. ستظهر الخريطة المعدّلة بعد ذلك.

JavaScript

لإنشاء خريطة باستخدام رقم تعريف خريطة في رمز تطبيقك:

  1. إذا كنت بصدد تخصيص خريطتك باستخدام رمز JSON مضمّن، أزِل styles من عنصر MapOptions، وإلا، تخطّ هذه الخطوة.

  2. أضِف رقم تعريف خريطة إلى الخريطة باستخدام السمة mapId. على سبيل المثال:

map = new google.maps.Map(document.getElementById('map'), {
center: {lat: -34.397, lng: 150.644},
zoom: 8,
mapId: 'MAP_ID'
});

Maps Static

لإضافة معرّف خريطة إلى خريطة جديدة أو حالية تستخدم إحدى واجهتَي برمجة التطبيقات لخدمات الويب، يمكنك إلحاق مَعلمة عنوان URL‏ map_id وضبطها على معرّف الخريطة. يوضّح هذا المثال إضافة معرّف خريطة إلى خريطة باستخدام واجهة برمجة التطبيقات Maps Static API.

<img src="https://maps.googleapis.com/maps/api/staticmap?center=Brooklyn+Bridge,New+York,NY&zoom=13&size=600x300&maptype=roadmap&markers=color:blue%7Clabel:S%7C40.702147,-74.015794&markers=color:green%7Clabel:G%7C40.711614,-74.012318&markers=color:red%7Clabel:C%7C40.718217,-73.998284&key=YOUR_API_KEY&map_id=MAP_ID&signature=YOUR_SIGNATURE" />

خريطة تركّز على جسر بروكلين في مدينة نيويورك، نيويورك، الولايات المتحدة مع عناصر التحكّم في الخريطة في أسفل يسار الصفحة تعرض الخريطة تصميمًا مخصّصًا للطرق والمسطحات المائية والأراضي.

إذا كان لديك توقيع رقمي في عنوان URL الثابت في "خرائط Google" قبل إضافة رقم تعريف الخريطة، عليك إنشاء وإضافة توقيع رقمي جديد بعد إضافة رقم تعريف الخريطة. عند إنشاء سر توقيع عنوان URL الجديد، تذكَّر إزالة ملف توقيعك الرقمي السابق من عنوان URL.