שימוש במפתחות API עם Directions API (גרסה קודמת)

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

איך יוצרים, מגבילים ומשתמשים במפתח API ב-Google Maps Platform.

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

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

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

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

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

המסוף

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

    כניסה לדף Credentials

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

Cloud SDK

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

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

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

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

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

המסוף

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

    כניסה לדף Credentials

  2. בוחרים את מפתח ה-API שרוצים להגביל. דף המאפיינים של מפתח ה-API מופיע.
  3. בקטע Key restrictions, מגדירים את ההגבלות הבאות:
    • הגבלות על אפליקציות:
      1. כדי לקבל בקשות מרשימת כתובות ה-IP של שרתי האינטרנט שסיפקתם, בוחרים באפשרות IP addresses (web servers, משימות cron, etc.)‎ ברשימה Application restrictions. צריך לציין כתובת IPv4 או IPv6 אחת או יותר, או רשת משנה באמצעות סימון CIDR. כתובות ה-IP צריכות להתאים לכתובת המקור ששרתי Google Maps Platform מזהים. אם אתם משתמשים בתרגום כתובות רשת (NAT), בדרך כלל הכתובת הזו תתאים לכתובת ה-IP הציבורית של המכונה.
    • הגבלות על ממשקי API:
      1. לוחצים על Restrict key.
      2. בתפריט הנפתח Select APIs, בוחרים באפשרות Directions API (Legacy)‎. אם Directions API (Legacy)‎ לא מופיע ברשימה, צריך להפעיל אותו.
  4. כדי לשמור את השינויים, לוחצים על שמירה.

Cloud SDK

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

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

מנקים את ההגבלות הקיימות על המפתח הקיים. 

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

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

gcloud services api-keys update projects/PROJECT/locations/global/keys/KEY_ID \
    --api-target=service=directions-backend.googleapis.com
    --allowed-ips="IP_ADDRESS"

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

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

בכל בקשה ל-Directions API (דור קודם) צריך לכלול מפתח API. בדוגמה הבאה, מחליפים את YOUR_API_KEY במפתח ה-API שלכם:

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

בבקשות שמשתמשות במפתח API, צריך להשתמש ב-HTTPS.