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

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 Studio، أنشِئ تطبيقك وشغِّله بالطريقة المعتادة. سيتم تطبيق الأنماط المخصصة، كما تم تكوينها في الخطوة الأولى، على جميع الخرائط ذات المعرف.

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