הגדרת Navigation Connect

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

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

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

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

  1. בדיקת החיוב והעלות של השימוש ב-Navigation Connect Usage and Billing.
  2. מוודאים שיש לכם חשבון Google Cloud.

    נכנסים למסוף Google Cloud
  3. מוודאים שיש לכם פרויקט ב-Google Cloud שהחיוב מופעל בו.

    כניסה לדף Billing
    1. בוחרים את הפרויקט כדי לפתוח את הדף Billing.
    2. בדף Billing:

      • אם החיוב כבר מופעל בפרויקט שנבחר ויש לכם רק חשבון לחיוב אחד, ייפתח הדף Billing.
      • אם יש לכם כמה חשבונות לחיוב, לוחצים על Go to linked billing account כדי לראות את הפרטים של החשבון לחיוב שמשויך לפרויקט.
      • אם יש חשבון לחיוב אבל הוא לא משויך לפרויקט, תתבקשו לקשר חשבון לחיוב לפרויקט.
      • אם אין חשבון לחיוב או שרוצים ליצור חשבון חדש לחיוב, בוחרים באפשרות Manage Billing Accounts כדי ליצור חשבון חדש לחיוב. למידע נוסף, קראו את המאמר איך יוצרים חשבון חדש לחיוב ב-Cloud בממשק בניהול עצמי.

הפעלת ה-API ואימות האפליקציה

במדריך הזה מוסבר איך להפעיל את Navigation Connect API ולאמת את האפליקציה במסוף Google Cloud, כדי שהאפליקציה תוכל להתממשק בצורה מאובטחת עם מפות Google ו-Waze. כדי להשתמש ב-Navigation Connect API, אתם צריכים להשלים את התהליך הזה.

1. הפעלת Navigation Connect API

אתם יכולים להפעיל את Navigation Connect API בפרויקט ב-Google Cloud באמצעות מסוף Google Cloud או הפקודה gcloud.

כדי להפעיל את ה-API:

המסוף

  1. פותחים את דף המוצר במסוף Google Cloud:

    הפעלת Navigation Connect API
  2. לוחצים על הכפתור הפעלה.

gcloud

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

מידע נוסף על Google Cloud SDK, התקנת Cloud SDK והפקודות הבאות:

2. התחלת תהליך אימות האפליקציה

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

כדי להתחיל את תהליך האימות, אפשר להשתמש באחת מהשיטות הבאות:

  • זירת המסחר של ה-API:
    1. ב- API Marketplace, מחפשים את הכרטיס Navigation Connect API.
    2. לוחצים על הסמל הכחול נדרש אימות כדי להתחיל את תהליך האימות.
  • מפתחות ופרטי כניסה במסוף Google Cloud:
    1. נכנסים לדף Keys & Credentials במסוף Google Cloud.
    2. לוחצים על Navigation Connect Keys and Credentials.
    3. בבאנר, לוחצים על התחלת תהליך האימות.

3. הוספת פרטים על האפליקציה, איסוף הנתונים והפרטיות

בטבלה הבאה מפורטים הפרטים שצריך לספק כדי לאמת את האפליקציה:

שדה תיאור
פרטי האפליקציה

כדי לוודא שהאפליקציה תוצג בצורה נכונה במפות Google וב-Waze, צריך לספק את הפרטים הבאים.

שם העסק או האפליקציה מזינים את השם שיוצג למשתמשים במפות Google וב-Waze.
מזהה האפליקציה מזינים את שם החבילה ב-Android או את מזהה החבילה ב-iOS.
קישור אוניברסלי ל-iOS צריך לספק את הקישור האוניברסלי ל-iOS שמאפשר למשתמשים לחזור לאפליקציה (זמין ב-Waze בלבד).
לוגו של האפליקציה (Waze בלבד) (אופציונלי) מעלים לוגו בפורמט PNG או JPG (בגודל 32x32 עד 128x128 פיקסלים) כדי להציג את הלוגו של האפליקציה ב-Waze במהלך הניווט.
פרטים על איסוף נתונים ופרטיות

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

קישור למדיניות הפרטיות מזינים את כתובת ה-URL של מדיניות הפרטיות של האפליקציה. הקישור הזה מופיע במסך ההסכמה.
נאמני מידע נוספים (אופציונלי) צריך לציין את השם המסחרי ואת הקישור למדיניות הפרטיות של כל מנהלי נתונים מצד שלישי, כמו ISV. הפרטים האלה מופיעים במסך ההסכמה.
תאימות הנתונים אם האפליקציה פועלת בארצות הברית, צריך לסמן את התיבה This app will be used for trips occurring in the United States כדי לוודא שהיא עומדת בתקנות המקומיות.

4. בדיקה ושליחה

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

  1. בודקים היטב את שם האפליקציה, הפלטפורמה, המזהים והקישורים.

  2. מסמנים את התיבה כל המידע מדויק.
  3. לוחצים על שליחה.

אחרי ששולחים את האפליקציה לאימות, מתחיל שלב הבדיקה.

  • משך הזמן: תהליך האימות נמשך בדרך כלל 1-3 ימי עסקים.
  • התראה: תקבלו אימייל כשסטטוס האימות ישתנה. בנוסף, תקבלו אימייל עם בקשה למסור את מספר פרופיל התשלומים או את מזהה המפתח שלכם ב-Android. אם אתם צריכים מזהה מפתח ל-Android, קראו את המאמר יצירת חשבון פיתוח.
  • מעקב אחרי הסטטוס: אתם יכולים לעקוב אחרי ההתקדמות בדף Keys and Credentials במסוף Google Cloud.
  • תמיכה: כדי לעדכן את ההגדרות אחרי האישור בלי להשפיע על סביבת הייצור, אתם יכולים ליצור כרטיס תמיכה.

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

כדי למנוע שימוש לא מורשה, במוצרים של Google Maps Platform צריך לכלול אסימון OAuth בקריאות ל-API.

יצירת טוקן OAuth

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

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

אתם יכולים לשלוח בקשות API ישירות לשרת של Google Maps API, או להשתמש בספריות לקוח כדי לפשט את הקוד. במפות Google יש ספריות לקוח ל-Go, ל-Java, ל-Node.js ול-Python. מידע נוסף זמין במאמר ספריות לקוח של Navigation Connect.

סקירה כללית על OAuth

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

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

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

התהליך הבא של REST מיועד רק לפיתוח או לבדיקה, ולא לייצור.

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

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

  1. מתקינים ומפעילים את ה-CLI של gcloud. למידע נוסף, קראו את המאמר התקנת ה-CLI של gcloud.

  2. אימות באמצעות ה-CLI של gcloud:

    gcloud auth application-default login
  3. משלימים את תהליך הכניסה כדי לשמור את פרטי הכניסה בקובץ פרטי הכניסה המקומי שמשמש את ADC.

מידע נוסף זמין במאמר הגדרת 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, מבצעים את השלבים הבאים:

  1. בדוגמת הקוד הבאה, מחליפים את ה-placeholders בערכים שלכם:

    • ‫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",
    }'
  2. כדי להעתיק את הפקודה curl, לוחצים על Copy בדוגמת הקוד.

  3. מדביקים את הפקודה בחלון הטרמינל ומריצים אותה.

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

פתרון בעיות

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

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

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

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