כדאי לנסות את הדור הבא של תכונות מסלול באמצעות Routes API, שזמין עכשיו בתצוגה המקדימה.

שימוש במפתחות API עם DIRECTION API

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

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

במדריך הזה מוסבר איך ליצור, להגביל ולהשתמש במפתח ה-API בפלטפורמה של מפות Google.

לפני שמתחילים

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

יצירת מפתחות API

מפתח ה-API הוא מזהה ייחודי שמאמת בקשות המשויכות לפרויקט למטרות שימוש וחיוב. צריך להיות לכם לפחות מפתח API אחד המשויך לפרויקט.

כך יוצרים מפתח API:

מסוף

  1. נכנסים לדף Google Maps Platform > credentials.

    לדף פרטי הכניסה

  2. בדף פרטי כניסה, לוחצים על יצירת פרטי כניסה > מפתח API.
    תיבת הדו-שיח מפתח API שנוצר תציג את מפתח ה-API החדש שיצרת.
  3. לוחצים על סגירה.
    מפתח ה-API החדש מופיע בדף פרטי כניסה בקטע מפתחות API.
    (זכרו להגביל את ה-API לפני השימוש בו בסביבת הייצור.)

Cloud SDK

gcloud alpha services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

הגבלת מפתחות API

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

כדי להגביל מפתח API:

מסוף

  1. נכנסים לדף Google Maps Platform > credentials.

    לדף פרטי הכניסה

  2. בוחרים את מפתח ה-API שרוצים להגדיר עבורו הגבלה. יופיע דף הנכס של מפתח ה-API.
  3. בקטע הגבלות עיקריות, מגדירים את ההגבלות הבאות:
    • הגבלות על אפליקציות:
      1. כדי לקבל בקשות מרשימת כתובות ה-IP של שרתי האינטרנט שאתם מספקים, בוחרים באפשרות כתובות IP (שרתי אינטרנט, משימות cron וכו') מרשימת ההגבלות על האפליקציות. יש לציין כתובת IPv4 או IPv6 אחת או תת-רשת אחת באמצעות סימון CIDR (למשל 192.168.0.0/22). מכיוון שבקשת שירות אינטרנט של שירות אינטרנט בודקת את כתובת ה-IP החיצונית ומשווה אותה להגבלת המפתח של ה-API, יש להשתמש בכתובת ה-IP הציבורית של השרת.
    • הגבלות API:
      1. לוחצים על הגבלת מפתח.
      2. בוחרים באפשרות DIRECTION API מהתפריט הנפתח Select APIs. אם המוצר API של מסלול לא מופיע ברשימה, עליך להפעיל אותו.
  4. כדי לסיים את השינויים, לוחצים על שמירה.

Cloud SDK

הצגת רשימה של מפתחות קיימים. 

gcloud services api-keys list --project="PROJECT"

יש להסיר את ההגבלות הקיימות מהמפתח הקיים. 

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

הגדרת הגבלות חדשות על מקש קיים. 

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api_target="directions-backend.googleapis.com"
    --allowed-ips="IP_ADDRESS"

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

הוספת מפתח ה-API לבקשה שלך

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

https://maps.googleapis.com/maps/api/directions/json?origin=Toronto&destination=Montreal&key=YOUR_API_KEY

יש להזין HTTPS עבור בקשות המשתמשות במפתח API.