הגדרת Navigation Connect

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

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

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

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

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

הפעלת ה-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 Marketplace:
    1. ב API Marketplace, מחפשים את הכרטיס Navigation Connect API.
    2. כדי להתחיל את תהליך האימות, לוחצים על הסמל הכחול נדרש אימות.
  • מפתחות ופרטי כניסה במסוף Google Cloud:
    1. במסוף Google Cloud, נכנסים לדף Keys & Credentials.
    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 Developer Identity. אם אתם צריכים מזהה מפתח ל-Android, תוכלו לעיין במאמר בנושא יצירת חשבון פיתוח.
  • מעקב אחר הסטטוס: אפשר לעקוב אחרי ההתקדמות בדף Keys and Credentials במסוף Google Cloud.
  • תמיכה: כדי לעדכן את ההגדרה אחרי האישור בלי להשפיע על הייצור, צריך ליצור כרטיס תמיכה.

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