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

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

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

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

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

لإنشاء أو إدارة أي معرّفات خرائط أو أنماط خرائط في مشروع معيّن على 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 Studio، أنشِئ تطبيقك وشغِّله بالطريقة المعتادة. سيتم تطبيق الأنماط المخصصة، كما تم تكوينها في الخطوة الأولى، على جميع الخرائط ذات المعرف.

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'
});

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

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

<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 وMaps Static API)

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