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

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

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