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

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