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

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

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

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

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

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

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

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

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

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

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

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

ربط رقم تعريف خريطة بنمط خريطة

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

  1. في وحدة التحكّم في Cloud، انتقِل إلى صفحة "إدارة الخرائط".
  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 واضبطها على رقم تعريف الخريطة. يوضح هذا المثال إضافة رقم تعريف خريطة إلى خريطة باستخدام واجهة برمجة التطبيقات الثابتة في "خرائط 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 وMaps Static API)

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