המוצר או התכונה האלה הם ניסיוניים (טרום-GA). יכול להיות שהתמיכה במוצרים ובתכונות בגרסת טרום-GA תהיה מוגבלת, ושינויים במוצרים ובתכונות בגרסת טרום-GA לא יהיו תואמים לגרסאות אחרות של טרום-GA. השימוש במוצרים בגרסת טרום-GA כפוף לתנאים הספציפיים לשירות של Google Maps Platform. מידע נוסף זמין בקטע תיאורים של שלבי ההשקה.

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

הגדרת Navigation Connect

מפתחים באזור הכלכלי האירופי (EEA)

במאמר הזה נסביר איך מתחילים להשתמש ב-Navigation Connect.

מוודאים שאתם עומדים בדרישות המוקדמות.

מפעילים את ה-API בפרויקט בענן ב-Google Cloud.

הגדרת OAuth כדי לשלוח בקשת API מאומתת.

המוצרים של Google Maps Platform מוגנים מפני שימוש לא מורשה, ולכן קריאות ל-API צריכות לכלול טוקן OAuth.

יצירת טוקן OAuth

‫Navigation Connect תומך בשימוש ב-OAuth 2.0 לצורך אימות. ‫Google תומכת בתרחישים נפוצים של OAuth 2.0, כמו אלה של שרת אינטרנט.

במאמר הזה מוסבר איך להעביר טוקן OAuth לקריאה של Navigation Connect בסביבת הפיתוח. הוראות לשימוש ב-OAuth בסביבת ייצור זמינות במאמר בנושא שיטות אימות ב-Google.

מידע על OAuth

יש הרבה דרכים ליצור ולנהל טוקנים של גישה באמצעות OAuth, בהתאם לסביבת הפריסה שלכם.

לדוגמה, מערכת Google OAuth 2.0 תומכת באינטראקציות בין שרתים, כמו אלה שבין האפליקציה שלכם לבין שירות של Google. במקרה הזה צריך חשבון שירות, שהוא חשבון ששייך לאפליקציה ולא למשתמש קצה ספציפי. האפליקציה שולחת קריאות ל-Google APIs בשם חשבון השירות, כך שהמשתמשים לא מעורבים באופן ישיר. מידע נוסף על שיטות אימות זמין במאמר בנושא שיטות אימות ב-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

דוגמה: התנסות בקריאות ל-API בארכיטקטורת REST בסביבת הפיתוח המקומית

אם אתם רוצים לנסות את Navigation Connect באמצעות טוקן OAuth, אבל אין לכם סביבה מוגדרת ליצירת טוקנים, אתם יכולים להשתמש בתהליך שבקטע הזה כדי לבצע את הקריאה.

בדוגמה הזו אנחנו מסבירים איך להשתמש באסימון OAuth שסופק על ידי Application Default Credentials ‏ (ADC) כדי לבצע את הקריאה. במאמר אימות באמצעות ספריות לקוח תוכלו ללמוד איך משתמשים ב-ADC כדי לקרוא ל-Google APIs באמצעות ספריות לקוח.

דרישות מוקדמות

כדי שתוכלו לשלוח בקשת REST באמצעות ADC, אתם צריכים קודם להשתמש ב-Google Cloud CLI כדי לספק ל-ADC את פרטי הכניסה:

מתקינים ומפעילים את ה-CLI של gcloud.
מריצים את הפקודה gcloud הבאה במחשב המקומי כדי ליצור את קובץ פרטי הכניסה:
```
gcloud auth application-default login
```
מסך התחברות יוצג לפניכם. אחרי שמתחברים, פרטי הכניסה נשמרים בקובץ פרטי הכניסה המקומי שמשמש את ADC.

מידע נוסף זמין במאמר הגדרת ADC לסביבת פיתוח מקומית.

שליחת בקשת REST

בדוגמה הזו, מעבירים שתי כותרות בקשה:

מעבירים את אסימון ה-OAuth בכותרת Authorization באמצעות הפקודה הבאה ליצירת האסימון:

gcloud auth application-default print-access-token

הטוקן שמוחזר הוא בהיקף של https://www.googleapis.com/auth/cloud-platform.
מעבירים את המזהה או השם של פרויקט בענן ב-Google שבו מופעל החיוב בכותרת X-Goog-User-Project.

בדוגמה הבאה מבוצעת קריאה ל-Navigation Connect באמצעות אסימון OAuth.

עורכים את השדה PROJECT_ID כדי להעביר את המזהה של פרויקט בענן ב-Google Cloud.

עורכים גם את הפרטים הבאים, לפי הצורך:

‫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: מזהה הנסיעה שנוצר על ידי ה-Backend בפורמט UUIDv4.
‫BASE64_ENCODED_TRIP_TOKEN: האסימון המאומת שמוחזר על ידי השיטה createTrip. מעבירים את הטוקן הזה לאפליקציה לנייד כדי להתחיל ניווט מפורט במפות Google או ב-Waze.

פתרון בעיות

אם הבקשה מחזירה הודעת שגיאה שלפיה ה-API לא תומך בפרטי הכניסה של משתמשי הקצה, עיינו במאמר פתרון בעיות בהגדרות של ADC.

המאמרים הבאים

השלב הבא בהגדרת Navigation Connect API הוא הגדרת חשבונות השירות כדי לאפשר תקשורת מאובטחת בין השרתים של תשתית הבק-אנד לבין Google Maps ו-Waze.

הגדרת חשבון שירות