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