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

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

إعداد ميزة "التنقل المتصل"

المطوّرون في المنطقة الاقتصادية الأوروبية

يوضّح هذا المستند الخطوات اللازمة لبدء استخدام Navigation Connect.

تأكَّد من استيفاء الشروط الأساسية.

فعِّل واجهة برمجة التطبيقات في مشروعك على Google Cloud.

اضبط بروتوكول OAuth لإجراء طلب بيانات مصادق عليه من واجهة برمجة التطبيقات.

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

إنشاء رمز مميّز OAuth

تتيح ميزة Navigation Connect استخدام بروتوكول OAuth 2.0 للمصادقة. تتيح Google سيناريوهات OAuth 2.0 الشائعة، مثل سيناريوهات خادم الويب.

يوضّح هذا المستند كيفية تمرير رمز OAuth المميّز إلى طلب Navigation Connect في بيئة التطوير. للحصول على تعليمات حول استخدام OAuth في بيئة إنتاج، راجِع طرق المصادقة في Google.

لمحة عن OAuth

تتوفّر طرق عديدة لإنشاء رموز الدخول وإدارتها باستخدام OAuth استنادًا إلى بيئة النشر.

على سبيل المثال، يتيح نظام Google OAuth 2.0 التفاعلات بين الخوادم، مثل التفاعلات بين تطبيقك وإحدى خدمات Google. في هذه الحالة، تحتاج إلى حساب خدمة، وهو حساب يخص تطبيقك بدلاً من مستخدم نهائي فردي. يطلب تطبيقك من واجهات برمجة تطبيقات Google تنفيذ إجراءات بالنيابة عن حساب الخدمة، وبالتالي لا يشارك المستخدمون بشكل مباشر. لمزيد من المعلومات عن طرق المصادقة، يُرجى الاطّلاع على طرق المصادقة في Google.

بدلاً من ذلك، يمكنك استخدام Navigation Connect كجزء من تطبيق جوّال على Android أو iOS. للحصول على معلومات عامة حول استخدام OAuth مع Navigation Connect، بما في ذلك معلومات حول إدارة رموز الدخول لبيئات النشر المختلفة، يُرجى الاطّلاع على استخدام OAuth 2.0 للوصول إلى Google APIs.

لمحة عن نطاقات OAuth

لاستخدام OAuth مع Navigation Connect، يجب منح رمز OAuth المميز النطاق التالي:

https://www.googleapis.com/auth/cloud-platform

مثال: تجربة طلبات البيانات من واجهة REST API في بيئة التطوير المحلية

إذا أردت تجربة ميزة Navigation Connect باستخدام رمز مميّز لبروتوكول OAuth، ولكن لم يتم إعداد بيئة لإنشاء الرموز المميّزة، يمكنك استخدام الإجراء الوارد في هذا القسم لإجراء المكالمة.

يوضّح هذا المثال كيفية استخدام رمز OAuth المميز الذي توفّره بيانات الاعتماد التلقائية للتطبيق (ADC) لإجراء الطلب. للحصول على معلومات حول استخدام ADC لطلب بيانات من Google APIs باستخدام مكتبات برامج، راجِع مقالة المصادقة باستخدام مكتبات برامج.

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

قبل أن تتمكّن من تقديم طلب REST باستخدام ADC، استخدِم Google Cloud CLI لتوفير بيانات الاعتماد إلى ADC:

تثبيت gcloud CLI وإعداده
نفِّذ الأمر gcloud التالي على جهازك المحلي لإنشاء ملف بيانات الاعتماد:
```
gcloud auth application-default login
```
تظهر شاشة تسجيل الدخول. بعد تسجيل الدخول، يتم تخزين بيانات الاعتماد في ملف بيانات الاعتماد المحلي الذي تستخدمه ميزة "التحكّم التكيّفي في الوصول".

لمزيد من المعلومات، يُرجى الاطّلاع على إعداد ADC لبيئة تطوير محلية.

إجراء طلب REST

في هذا المثال، يمكنك تمرير عنوانَي طلب:

مرِّر رمز OAuth المميز في العنوان Authorization باستخدام الأمر التالي لإنشاء الرمز المميز:

gcloud auth application-default print-access-token

يحتوي الرمز المميّز الذي تم إرجاعه على نطاق https://www.googleapis.com/auth/cloud-platform.
مرِّر رقم تعريف أو اسم مشروعك على Google Cloud الذي تم تفعيل الفوترة فيه في العنوان X-Goog-User-Project.

يُجري المثال التالي طلبًا إلى Navigation Connect باستخدام رمز OAuth مميز.

عدِّل الحقل PROJECT_ID لتمرير رقم تعريف مشروعك على السحابة الإلكترونية من Google.

عدِّل أيضًا ما يلي، حسب الاقتضاء:

ANDROID_APP_ID: اسم حزمة Android لتطبيقك
‫IOS_APP_ID: هو معرّف حزمة iOS لتطبيقك.

#!/bin/bash

trip_id="$(uuidgen)"
access_token="$(gcloud auth application-default print-access-token)"

curl -X POST "https://navigationconnect.googleapis.com/v1/projects/PROJECT_ID/trips?tripId=${trip_id}" \
  -H "Authorization: Bearer ${access_token}" \
  -H "Content-Type: application/json" \
  -d '{
  "androidAppId": "ANDROID_APP_ID",
  "iosAppId": "IOS_APP_ID",
}'

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

الردّ هو عنصر JSON:

{
  "name": "projects/PROJECT_NUMBER/trips/TRIP_ID",
  "authToken": {
    "token": "BASE64_ENCODED_TRIP_TOKEN",
    "expireTime": "2026-03-06T11:09:47.476942Z"
  },
  "state": "NEW",
  "execution": {
    "traveledDistanceMeters": 0,
    "stopAddedInRoute": false
  },
  "createTime": "2026-03-05T23:09:50.768959Z",
  "updateTime": "2026-03-05T23:09:50.768959Z",
}

يتضمّن هذا الرد القيم التالية:

PROJECT_NUMBER: المعرّف الفريد ذو العدد الصحيح الطويل للمشروع.
TRIP_ID: رقم تعريف الرحلة الذي أنشأه الخلفية بتنسيق UUIDv4.
‫BASE64_ENCODED_TRIP_TOKEN: الرمز المميّز الذي تم التحقّق منه والذي تعرضه الطريقة createTrip. مرِّر الرمز المميّز إلى تطبيقك على الأجهزة الجوّالة لبدء اتجاهات مفصّلة يتم تتبّعها في "خرائط Google" أو Waze.

تحديد المشاكل وحلّها

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

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

الخطوة التالية لإعداد Navigation Connect API هي إعداد حسابات الخدمة لتفعيل التواصل الآمن بين الخادمين بين البنية الأساسية الخلفية و"خرائط Google" وWaze.

إعداد حساب الخدمة