הגדרת 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

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

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

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

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

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

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

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

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

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