تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

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

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

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

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

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

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

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

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

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 واضبطها على رقم تعريف الخريطة. يوضح هذا المثال إضافة معرّف خريطة إلى خريطة باستخدام 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)

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