استخدام أرقام تعريف الخرائط

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