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

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

وعند الإنشاء، يتم ربط أرقام تعريف الخرائط بمشروع، كما يتم حصرها على نظام أساسي واحد (Android وiOS وجافا سكريبت) أو واجهة برمجة تطبيقات الخرائط الثابتة.

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

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

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

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

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

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

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

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

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

ربط معرف خريطة بنمط الخريطة

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

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

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

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

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

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

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