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

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

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

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

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

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

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

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

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

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

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

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

ربط رقم تعريف خريطة بأسلوب خريطة

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

  1. في Cloud Console، انتقِل إلى صفحة "إدارة خرائط Google".
  2. في هذه الصفحة، اختَر رقم تعريف خريطة حالي من عمود اسم الخريطة.
  3. في أسفل هذا النموذج، اختَر نمط خريطة من القائمة المنسدلة أنماط الخريطة المرتبطة برقم تعريف الخريطة هذا.
  4. انقر على حفظ.
    لقطة شاشة تعرض صفحة التفاصيل لرقم تعريف خريطة واحد، بما في ذلك حقل القائمة المنسدلة الذي يتيح للمستخدمين ربط نمط خريطة برقم تعريف الخريطة هذا

إضافة معرّف الخريطة إلى تطبيقك

Android

أضِف رقم تعريف الخريطة من خلال عنصر <fragment> فيملف <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'
});

Maps Static

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

<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