استخدام معرّفات الخرائط
معرّف الخريطة هو معرّف مرتبط بنمط خريطة أو ميزة معيّنة. يمكنك ضبط نمط خريطة وربطه برقم تعريف الخريطة في Google Cloud Console. وبعد ذلك، عندما تشير إلى معرّف خريطة في الرمز البرمجي الخاص بك، يتم عرض نمط الخريطة المرتبط به في تطبيقك. وتظهر في تطبيقك تلقائيًا أي تعديلات لاحقة تُجريها على الأنماط، بدون الحاجة إلى إجراء أي تعديلات من قِبل عملائك.
عند الإنشاء، يتم ربط معرّفات الخرائط بمشروع وتقتصر أيضًا على نظام أساسي واحد (Android أو iOS أو JavaScript) أو بـ Maps Static API.
لإنشاء أي معرّفات خرائط أو إدارتها في Cloud Console، يجب أن يكون لديك دور مالك المشروع أو محرِّر المشروع.
الأذونات المطلوبة
لإنشاء أو إدارة أي معرّفات خرائط أو أنماط خرائط في مشروع معيّن على Google Cloud، يجب أن تمتلك دور المالك أو المحرِّر "إدارة الهوية وإمكانية الوصول" في المشروع.
إنشاء معرّف خريطة
معرِّف الخريطة هو معرِّف فريد يمثّل مثيلاً واحدًا من "خريطة Google". يمكنك إنشاء معرّفات خرائط وتعديل نمط مرتبط بمعرّف خريطة في أي وقت في Cloud Console.
لإنشاء معرّف خريطة:
- في Cloud Console، انتقِل إلى صفحة "إدارة الخرائط".
- اختر إنشاء رقم تعريف خريطة جديد لعرض نموذج إنشاء رقم تعريف جديد للخريطة.
في النموذج، قم بما يلي:
- حدِّد اسم خريطة.
- حدد نوع الخريطة أو النظام الأساسي.
- بالنسبة إلى خرائط JavaScript، اختر نوع الخريطة النقطية أو المتجهة.
- أدخل وصفًا للخريطة.
- اختَر التالي لعرض معرّف الخريطة الجديد.
ربط رقم تعريف خريطة بنمط خريطة
تفترض هذه التعليمات أن هناك نمط خريطة موجود واحدًا على الأقل في مشروعك.
- في Cloud Console، انتقِل إلى صفحة "إدارة الخرائط".
- في هذه الصفحة، اختَر معرّف خريطة حالي من عمود اسم الخريطة.
- في أسفل هذا النموذج، اختر نمط خريطة من القائمة المنسدلة أنماط الخريطة المرتبطة برقم تعريف الخريطة هذا.
- اختَر حفظ.
إضافة رقم تعريف الخريطة إلى تطبيقك
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 Studio، أنشِئ تطبيقك وشغِّله بالطريقة المعتادة. سيتم تطبيق الأنماط المخصصة، كما تم تكوينها في الخطوة الأولى، على جميع الخرائط ذات المعرف.
iOS
لإنشاء مثيل للخريطة باستخدام معرف خريطة، قم بما يلي:
- أنشِئ
GMSMapID
باستخدام سلسلة معرّف الخريطة من Cloud Console. - يمكنك إنشاء
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
لإنشاء خريطة تتضمن معرّف خريطة في رمز تطبيقك:
إذا كنت حاليًا بصدد تخصيص خريطتك باستخدام رمز JSON المضمّن، أزِل السمة
styles
من كائنMapOptions
، وبخلاف ذلك، يمكنك تخطّي هذه الخطوة.أضِف رقم تعريف الخريطة إلى الخريطة باستخدام السمة
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" />
الميزات المتوفرة عند استخدام معرّفات الخرائط
تصميم الخرائط المستندة إلى السحابة الإلكترونية: يمكنك تصميم الخرائط وتخصيصها وإدارتها باستخدام Google Cloud Console.
متاح على جميع الأنظمة الأساسية (Android وJavaScript وiOS وMaps Static API)
خرائط المتجهات: خريطة مكونة من مربعات متجهة، يتم رسمها في وقت التحميل من جهة العميل باستخدام WebGL.
متاح على JavaScript