سيتوفّر تصميم الخريطة الجديد قريبًا على "منصة خرائط Google". يتضمن هذا التحديث على تصميم الخريطة لوحة ألوان تلقائية جديدة وتحسينات على تجارب الخرائط وسهولة الاستخدام. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. للمزيد من المعلومات عن مدى التوفّر وكيفية تفعيل الميزة في وقت سابق، يُرجى الاطّلاع على نمط الخريطة الجديد في "منصة خرائط Google".

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

استخدام مفاتيح واجهة برمجة التطبيقات

اختيار النظام الأساسي: Android iOS JavaScript

قبل البدء

قبل بدء استخدام حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android، يجب أن يكون لديك مشروع يتضمّن حساب فوترة ويجب أن تكون حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android مفعّلة. لمزيد من المعلومات، يُرجى الاطّلاع على الإعداد في وحدة تحكّم Cloud.

إنشاء مفاتيح واجهة برمجة التطبيقات

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

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

وحدة التحكّم

انتقِل إلى صفحة منصة خرائط Google > بيانات الاعتماد.

الانتقال إلى صفحة "بيانات الاعتماد"
في صفحة بيانات الاعتماد، انقر على إنشاء بيانات اعتماد > مفتاح واجهة برمجة التطبيقات.
يعرض مربّع الحوار مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه مفتاح واجهة برمجة التطبيقات الذي تم إنشاؤه حديثًا.
انقر على إغلاق.
يظهر مفتاح واجهة برمجة التطبيقات الجديد في صفحة بيانات الاعتماد ضمن مفاتيح واجهة برمجة التطبيقات.
(تذكَّر فرض قيود على مفتاح واجهة برمجة التطبيقات قبل استخدامه في مرحلة الإنتاج).

SDK للسحاب

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK و تثبيت Cloud SDK والأوامر التالية:

gcloud alpha services api-keys create

حظر مفاتيح واجهة برمجة التطبيقات

تنصح Google بشدة بتقييد مفاتيح واجهة برمجة التطبيقات من خلال حصر استخدامها في واجهات برمجة التطبيقات اللازمة لتطبيقك فقط. تؤدي القيود المفروضة على مفاتيح واجهة برمجة التطبيقات إلى تعزيز أمان تطبيقك من خلال حميته من الطلبات غير المبررة. لمزيد من المعلومات، يُرجى الاطّلاع على أفضل ممارسات أمان واجهة برمجة التطبيقات.

عند تقييد مفتاح واجهة برمجة التطبيقات، عليك تقديم الملف المرجعي لشهادة SHA-1 الخاص بمفتاح التوقيع الذي تم استخدامه لتوقيع التطبيق. هناك نوعان من الشهادات:

شهادة تصحيح الأخطاء: لا تستخدِم هذا النوع من الشهادات إلا مع التطبيقات التي تختبرها والرموز البرمجية الأخرى غير المخصّصة للإصدار العلني. لا تحاول نشر تطبيق موقَّع باستخدام شهادة تصحيح أخطاء. تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة تلقائيًا عند تشغيل إصدار debugging.
شهادة الإصدار: استخدِم هذه الشهادة عندما تكون مستعدًا لإصدار تطبيقك في متجر تطبيقات. تنشئ أدوات حزمة تطوير البرامج (SDK) لنظام التشغيل Android هذه الشهادة عند تشغيل إصدار علني.

لمزيد من المعلومات حول توقيع تطبيقات Android وشهاداتها، يُرجى الاطّلاع على دليل توقيع تطبيقك.

للحصول على تعليمات حول كيفية العثور على الملف المرجعي لشهادة التوقيع، اطّلِع على المراجع أدناه:

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

لتقييد مفتاح واجهة برمجة التطبيقات، اتّبِع الخطوات التالية:

وحدة التحكّم

انتقِل إلى صفحة منصة خرائط Google > بيانات الاعتماد.

الانتقال إلى صفحة "بيانات الاعتماد"
اختَر مفتاح واجهة برمجة التطبيقات الذي تريد فرض قيود عليه. ستظهر صفحة موقع مفتاح واجهة برمجة التطبيقات.
ضمن قيود المفاتيح، اضبط القيود التالية:

قيود التطبيق:

اختَر تطبيقات Android.
انقر على + إضافة اسم الحزمة وبصمة الإصبع.
أدخِل اسم الحزمة والملف المرجعي لشهادة SHA-1. على سبيل المثال:
```
com.example.android.mapexample
```
```
BB:0D:AC:74:D3:21:E1:43:67:71:9B:62:91:AF:A1:66:6E:44:5D:75
```

القيود المفروضة على واجهة برمجة التطبيقات:

انقر على تقييد المفتاح.
اختَر حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android من القائمة المنسدلة اختيار واجهات برمجة التطبيقات. إذا لم تكن حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لنظام التشغيل Android مُدرَجة، عليك تفعيلها.

لإنهاء التغييرات، انقر على حفظ.

SDK للسحاب

إدراج المفاتيح الحالية

gcloud services api-keys list --project="PROJECT"

أزِل القيود الحالية المفروضة على المفتاح الحالي.

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

يمكنك ضبط قيود جديدة على المفتاح الحالي.

gcloud alpha services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=maps-android-backend.googleapis.com
    --allowed-application=sha1_fingerprint=SHA1_FINGERPRINT,package_name=ANDROID_PACKAGE_NAME

يمكنك الاطّلاع على مزيد من المعلومات حول Google Cloud SDK و تثبيت Cloud SDK والأوامر التالية:

الخطوات التالية

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