معلَمات الطلب المطلوبة

لتقديم أي طلب إلى Maps Datasets API، يجب تضمين ما يلي:

  • رقم أو رقم تعريف مشروعك على Google Cloud في عنوان X-Goog-User-Project للطلب تحدد هذه القيمة المشروع المستخدم في حسابات الفوترة وحصص الاستخدام.

  • رمز OAuth مميَّز في عنوان Authorization للطلب. للحصول على مزيد من المعلومات حول استخدام OAuth مع واجهة برمجة تطبيقات مجموعات البيانات للخرائط، يمكنك الاطّلاع على استخدام OAuth.

  • رقم مشروع أو رقم تعريف على Google Cloud في عنوان URL للطلب تحدد هذه القيمة المشروع الذي يحتوي على مجموعة البيانات. علمًا أنّ هذا المشروع عادةً ما يكون هو نفسه المشروع المحدّد في عنوان X-Goog-User-Project، ليس من الضروري أن يكون واحدًا.

  • رقم تعريف مجموعة البيانات في عنوان URL للطلب. كلما قمت بتنفيذ إجراء على مجموعة بيانات محددة، فإنك تمرر معرف مجموعة البيانات كجزء من عنوان URL للطلب.

على سبيل المثال، لحذف مجموعة بيانات:

curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $(gcloud auth application-default print-access-token)" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

الحصول على رقم المشروع

للحصول على PROJECT_NUMBER_OR_ID من مشروعك على Google Cloud:

  1. انتقِل إلى صفحة Overview (نظرة عامة) للمشروع في Cloud Console.

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

  3. يظهر رقم المشروع ورقم تعريف المشروع في منطقة معلومات المشروع في شاشة النظرة العامة.

الحصول على رمز OAuth مميز

للمصادقة، يجب أن يحتوي طلب واجهة برمجة التطبيقات على رمز OAuth مميز في العنوان Authorization. لمزيد من المعلومات، يُرجى الاطّلاع على استخدام OAuth.

على سبيل المثال، استخدِم الأمر gcloud التالي لإنشاء الرمز المميّز:

gcloud auth application-default print-access-token

يمكنك تضمين الأمر gcloud مباشرةً في عنوان Authorization في أمر cURL لإنشاء رمز مميّز جديد لكل طلب، كما هو موضّح في المثال أعلاه.

بدلاً من ذلك، يمكنك ضبط متغيّر بيئة يحتوي على الرمز المميّز ثم ضبط متغير البيئة كجزء من الطلب:

export TOKEN=$(gcloud auth application-default print-access-token)
curl -X DELETE \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H "Authorization: Bearer $TOKEN" \
https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID