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

Android

أضِف رقم تعريف الخريطة من خلال عنصر <fragment> فيملف <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'
});

Maps Static

لإضافة معرف خريطة إلى خريطة جديدة أو حالية تستخدم إحدى واجهات برمجة التطبيقات لخدمات الويب، أضِف مَعلمة عنوان 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" />