كيفية إنشاء أرقام تعريف الخرائط

اختيار النظام الأساسي: Android iOS JavaScript خدمة الويب

معرّف الخريطة هو معرّف فريد يُستخدَم لتمثيل نسخة واحدة من "خرائط Google". يمكنك استخدام أرقام تعريف الخرائط لتفعيل الميزات أو إدارة الخرائط أو تصميمها على مواقعك الإلكترونية وفي تطبيقاتك. يمكنك إنشاء معرّفات خرائط لكل منصة تحتاج إليها، مثل JavaScript أو Android أو iOS أو "الخرائط الثابتة"، في مشروعك على Google Cloud Console ضمن صفحة إدارة الخرائط.

لمزيد من التفاصيل والميزات التي تستخدِم أرقام تعريف الخرائط، اطّلِع على نظرة عامة على أرقام تعريف الخرائط.

الأذونات المطلوبة

لإنشاء أي معرّفات خرائط في مشروعك أو إدارتها، يجب استخدام مبدأ أساسي يمتلك الأذونات المناسبة على مستوى الدور، مثل "المحرِّر" أو "المالك"، في صفحة "إدارة الهوية وإمكانية الوصول" في Cloud Console للمشروع. للاطّلاع على التفاصيل، يُرجى قراءة مرجع الأدوار الأساسية والمحدّدة مسبقًا لإدارة الهوية وإمكانية الوصول.

إنشاء أرقام تعريف الخرائط

أنشئ معرّفات الخرائط في Cloud Console باتّباع هذه الخطوات:

  1. سجِّل الدخول إلى مشروع على Cloud Console وافتحه باستخدام الأذونات المطلوبة.

  2. في وحدة تحكُّم Cloud Console، انتقِل إلى صفحة "إدارة خرائط Google".

  3. انقر على إنشاء رقم تعريف الخريطة.

    إنشاء معرّف خريطة جديد

  4. في صفحة إنشاء رقم تعريف خريطة جديد، اتّبِع الخطوات التالية:

    1. في الحقل الاسم، أدخِل اسمًا لرقم تعريف الخريطة.
    2. اختياري: في حقل الوصف، أدخِل الغرض من استخدام معرّف الخريطة.
    3. بالنسبة إلى نوع الخريطة، اختَر المنصة التي تخطِّط لاستخدام رقم تعريف الخريطة عليها. إذا اخترت JavaScript، اختَر أيضًا نوع خريطة Raster (التلقائي) أو Vector. لمزيد من المعلومات عن الخرائط المتجهّة، يُرجى الاطّلاع على مقالة الخرائط المتجهّة.
    4. انقر على حفظ لعرض رقم تعريف الخريطة الجديد.

ربط رقم تعريف خريطة بأسلوب خريطة

إذا كنت تستخدم ميزة "تصميم الخرائط" المستندة إلى السحابة الإلكترونية، يمكنك ربط تصميم خريطة برقم تعريف الخرائط. لمعرفة التفاصيل، يُرجى الاطّلاع على ربط.

إضافة معرّف الخريطة إلى تطبيقك

Android

أضِف رقم تعريف الخريطة من خلال عنصر <fragment> في ملف تنسيق النشاط، باستخدام فئة MapView، أو برمجيًا باستخدام فئة GoogleMapOptions.

على سبيل المثال، لنفترض أنّك أنشأت معرّف خريطة تم تخزينه كقيمة سلسلة باسم map_id في res/values/strings.xml:

<?xml version="1.0" encoding="utf-8"?>
<resources>
<string name="map_id">MAP_ID</string>
</resources>

بالنسبة إلى الخرائط التي تمت إضافتها من خلال عنصر <fragment> في ملف تنسيق النشاط، يجب أن تحدِّد جميع أجزاء الخريطة التي يجب أن تتضمّن النمط المخصّص رقم تعريف الخريطة في السمة map:mapId:

<fragment xmlns:map="http://schemas.android.com/apk/res-auto"
    map:name="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:

Java

 MapFragment mapFragment = MapFragment.newInstance(
     new GoogleMapOptions()
         .mapId(getResources().getString(R.string.map_id)));

Kotlin

 val mapFragment = MapFragment.newInstance(
     GoogleMapOptions()
         .mapId(resources.getString(R.string.map_id))
 )

في "استوديو Android"، أنشئ تطبيقك وشغِّله كالمعتاد. يتم تطبيق الأنماط المخصّصة التي تم ضبطها في الخطوة الأولى على جميع الخرائط التي تحتوي على رقم تعريف الخريطة المحدّد.

iOS

لإنشاء مثيل لخريطة باستخدام رقم تعريف الخريطة، اتّبِع الخطوات التالية:

  1. أنشئ GMSMapID باستخدام سلسلة معرّف الخريطة من Cloud Console.
  2. أنشئ GMSMapView يحدِّد رقم تعريف الخريطة الذي أنشأته للتو.

Swift

let camera = GMSCameraPosition(latitude: 47.0169, longitude: -122.336471, zoom: 12)
let mapID = GMSMapID(identifier: "MAP_ID")
let mapView = GMSMapView(frame: .zero, mapID: mapID, camera: camera)
self.view = mapView

Objective-C

GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:47.0169
                                                        longitude:-122.336471
                                                             zoom:12];
GMSMapID *mapID = [GMSMapID mapIDWithIdentifier:@"MAP_ID"];
GMSMapView *mapView = [GMSMapView mapWithFrame:CGRectZero mapID:mapID camera:camera];
self.view = mapView;

إذا كنت تستخدم معرّف الخريطة الخاص بك، يمكنك ضبط معرّف الخريطة في وحدة تحكّم Cloud للحصول على أسلوب جديد في أي وقت، وسيظهر هذا الأسلوب تلقائيًا في عرض الخريطة لك وللمستخدمين في غضون ست ساعات تقريبًا.

إذا كنت تريد الاطّلاع على التغييرات على الفور، يمكنك إغلاق تطبيقك وإعادة تشغيله من خلال الخروج من التطبيق وإغلاقه من قائمة التطبيقات التي تم استخدامها مؤخرًا، ثم إعادة فتحه. ستظهر الخريطة المعدّلة بعد ذلك.

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

<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=MAP_ID&signature=YOUR_SIGNATURE" />

خريطة تركّز على جسر بروكلين في مدينة نيويورك، نيويورك، الولايات المتحدة مع عناصر التحكّم في الخريطة في أسفل يسار الصفحة تعرض الخريطة تصميمًا مخصّصًا للطرق والمسطحات المائية والأراضي.

إذا كان لديك توقيع رقمي في عنوان URL الثابت في "خرائط Google" قبل إضافة رقم تعريف الخريطة، عليك إنشاء وإضافة توقيع رقمي جديد بعد إضافة رقم تعريف الخريطة. عند إنشاء سر توقيع عنوان URL الجديد، تذكَّر إزالة ملف توقيعك الرقمي السابق من عنوان URL.