استخدام معرّفات الخرائط

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

عند الإنشاء، يتم ربط معرّفات الخرائط بمشروع، وتقتصر أيضًا على نظام أساسي واحد (Android وiOS وJavaScript) أو بواجهة Maps Static API.

لإنشاء أو إدارة أي معرّفات خرائط في Cloud Console، يجب أن يكون لديك دور "مالك المشروع" أو "محرِّر إدارة الهوية وإمكانية الوصول" (IAM) في محرِّر المشروع.

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

لإنشاء أو إدارة أي معرّفات خرائط أو أنماط خرائط في مشروع معيّن على Google Cloud، يجب أن تمتلك دور المالك أو المحرِّر لإدارة الهوية وإمكانية الوصول في المشروع.

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

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

لإنشاء معرّف خريطة:

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

    في النموذج، قم بما يلي:

    • حدّد اسم خريطة.
    • حدد نوع الخريطة أو نظامها الأساسي.
    • بالنسبة إلى خرائط JavaScript، اختَر نوع الخريطة النقطية أو المتجهة.
    • أدخل وصفًا للخريطة.
    • انقر على التالي لعرض معرّف الخريطة الجديد.

ربط معرّف خريطة بنمط خريطة

تفترض هذه الإرشادات أن هناك نمط خريطة موجود واحدًا على الأقل في مشروعك.

  1. في Cloud Console، انتقِل إلى صفحة "إدارة الخرائط".
  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">YOUR_MAP_ID</string>
</resources>

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

<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
    class="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: "<YOUR 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:@"<YOUR 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'
});

الخرائط الثابتة

لإضافة معرّف خريطة إلى خريطة جديدة أو حالية تستخدِم إحدى واجهات برمجة تطبيقات خدمات الويب، أضِف معلَمة map_id لعنوان URL واضبطها على معرّف الخريطة. يوضّح هذا المثال إضافة معرّف خريطة إلى خريطة باستخدام واجهة برمجة التطبيقات الثابتة في "خرائط Google".

<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=YOUR_MAP_ID&signature=YOUR_SIGNATURE" />

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

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

الميزات المتاحة عند استخدام معرّفات الخرائط

تصميم الخرائط المستند إلى السحابة الإلكترونية: يمكنك تصميم الخرائط وتخصيصها وإدارتها باستخدام Google Cloud Console.
تتوفّر هذه الميزة على جميع الأنظمة الأساسية (أنظمة التشغيل Android وJavaScript وiOS وواجهة برمجة التطبيقات الثابتة للخرائط).

خرائط المتجهات: خريطة مكونة من مربّعات قائمة على المتجهات، يتم رسمها في وقت التحميل من جهة العميل باستخدام WebGL.
متاح على JavaScript