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