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

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

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

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

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

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

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

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

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

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

    في النموذج، يُرجى اتّباع الخطوات التالية:

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

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

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

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

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

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

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