استخدام معرّفات الخرائط

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:

 MapFragment mapFragment = MapFragment.newInstance(
     new GoogleMapOptions()
         .mapId(getResources().getString(R.string.map_id)));

 val mapFragment = MapFragment.newInstance(
     GoogleMapOptions()
         .mapId(resources.getString(R.string.map_id))
 )

في "استوديو Android"، صمِّم تطبيقك وشغِّله كالمعتاد. سيتم تطبيق الأنماط المخصّصة، كما تم ضبطها في الخطوة الأولى، على جميع الخرائط التي لها رقم تعريف.

iOS

لإنشاء مثيل لخريطة باستخدام معرف خريطة، اتبع الخطوات التالية:

1. أنشِئ GMSMapID باستخدام سلسلة رقم تعريف الخريطة من Cloud Console.
2. يجب إنشاء GMSMapView لتحديد رقم تعريف الخريطة الذي أنشأته للتو.

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

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

<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" />