إعداد Places SDK for Android

يوضّح هذا المستند الخطوات اللازمة لبدء استخدام حزمة تطوير البرامج (SDK) للأماكن في Android.

المتطلبات الأساسية

يساعدك هذا الإجراء في إعداد حساب على Google Cloud ومشروع على السحابة الإلكترونية مع تفعيل الفوترة. يجب أيضًا أن تكون على دراية بكيفية تحصيل الرسوم منك مقابل استخدام حزمة تطوير البرامج بالاستناد إلى الموقع الجغرافي لأجهزة Android.

  1. راجِع الفوترة وتكلفة الاستخدام في استخدام حزمة تطوير البرامج بالاستناد إلى بيانات الأماكن لنظام التشغيل Android والفوترة.

  2. تأكَّد من أنّ لديك حساب على Google Cloud.

    سجِّل الدخول إلى Google Cloud Console

  3. تأكَّد من أنّ لديك مشروعًا على Google Cloud تم تفعيل الفوترة فيه.

    انتقِل إلى صفحة "الفوترة"
    1. اختَر مشروعك لفتح صفحة الفوترة.

    2. في صفحة الفوترة:

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

تفعيل حزمة تطوير البرامج (SDK)

قبل استخدام Places SDK for Android، عليك استخدام Google Cloud Console أو الأمر gcloud لتفعيلها في مشروعك على Google Cloud.

تعتمد حزمة تطوير البرامج (SDK) للأماكن على Android على Places API (الجديدة). لتفعيل Places API (جديدة):

وحدة التحكّم

  1. افتح صفحة المنتج في Google Cloud Console:

    تفعيل Places API (الجديدة)

  2. يمكنك النقر على الزر تمكين.

gcloud

gcloud services enable \
    --project "PROJECT" \
    "places.googleapis.com"

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

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

تتم حماية منتجات "منصة خرائط Google" من الاستخدام غير المصرَّح به من خلال طلب تضمين مفتاح واجهة برمجة التطبيقات في طلبات البيانات من واجهة برمجة التطبيقات.

الحصول على مفتاح واجهة برمجة تطبيقات لاستخدامه مع Places API (الجديدة)

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

وحدة التحكّم

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

    الانتقال إلى صفحة "المفاتيح وبيانات الاعتماد"

  2. اختَر مشروعك إذا طُلب منك ذلك.

  3. نفّذ أيًا مما يلي:

    • إنشاء مفتاح جديد:

      1. انقر على إنشاء بيانات الاعتماد > مفتاح واجهة برمجة التطبيقات.
      2. في لوحة إنشاء مفتاح واجهة برمجة التطبيقات، افتح قائمة اختيار قيود واجهة برمجة التطبيقات.
      3. امسح أي واجهات برمجة تطبيقات لا يحتاجها هذا المفتاح، وتأكَّد من بقاء Places API (الجديدة) محدّدة.
      4. انقر على إنشاء. تعرض اللوحة مفتاح واجهة برمجة التطبيقات الجديد.

    • استخدام مفتاح حالي:

      1. انقر على اسم المفتاح.
      2. في قائمة اختيار قيود واجهة برمجة التطبيقات، اختَر Places API (جديدة).
      3. انقر على حفظ.

    لا يؤدي اختيار واجهة برمجة تطبيقات هنا إلى تفعيلها. تأكَّد من تفعيل Places API (الجديدة) في صفحة مكتبة واجهة برمجة التطبيقات.

  4. للاطّلاع على سلسلة المفاتيح لاحقًا، انتقِل إلى صفحة المفاتيح وبيانات الاعتماد وانقر على عرض المفتاح للمفتاح المطلوب.

إذا كانت وحدة التحكّم تبدو مختلفة عن هذه الخطوات، يمكنك الاطّلاع على إنشاء مفتاح واجهة برمجة التطبيقات وإضافة قيود على واجهة برمجة التطبيقات في مستندات Google Cloud.

gcloud

استبدِل PROJECT_ID برقم تعريف مشروعك في الأوامر التالية.

  • إنشاء مفتاح جديد: نفِّذ الأمر التالي، واستبدِل DISPLAY_NAME باسم المفتاح. 

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=places.googleapis.com

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

  • استخدام مفتاح حالي: نفِّذ الأمر التالي، واستبدِل KEY_ID بمعرّف المفتاح. تحتفظ العلامة --append بواجهات برمجة التطبيقات التي يسمح بها المفتاح حاليًا. وبدونها، يستبدلها الأمر.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=places.googleapis.com

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

    معرّف المفتاح ليس سلسلة المفتاح أو اسم العرض. للعثور عليه، شغِّل gcloud services api-keys list --project="PROJECT_ID". رقم التعريف هو الجزء الأخير من حقل name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

للاطّلاع على سلسلة المفاتيح، شغِّل gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

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

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

  • تحدّد القيود المفروضة على واجهة برمجة التطبيقات حِزم SDK وواجهات برمجة التطبيقات التي يمكن طلبها باستخدام مفتاح واجهة برمجة التطبيقات. تتطلّب وحدة التحكّم وgcloud CLI فرض قيد واحد على الأقل على واجهة برمجة التطبيقات عند إنشاء مفتاح.
  • تحدّد قيود التطبيقات المواقع الإلكترونية أو عناوين IP أو التطبيقات التي يمكنها استخدام مفتاح واجهة برمجة التطبيقات.

لمزيد من المعلومات حول تطبيق القيود، يُرجى الاطّلاع على مقالة فرض قيود على مفاتيح واجهة برمجة التطبيقات.

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

بعد تفعيل حزمة تطوير البرامج (SDK) للأماكن على أجهزة Android وضبط مفتاح واجهة برمجة التطبيقات، يمكنك الاطّلاع على مقالة إعداد مشروع على استوديو Android لمعرفة المزيد حول كيفية ضبط Xcode وكيفية تمرير مفتاح واجهة برمجة التطبيقات إلى تطبيقك.