שימוש במפתחות API עם Street View Static API

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

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

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

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

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

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

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

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

מסוף

  1. עוברים לדף פלטפורמה של מפות Google > פרטי כניסה.

    כניסה לדף Credentials

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

Cloud SDK

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

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

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

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

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

מסוף

  1. עוברים לדף פלטפורמה של מפות Google > פרטי כניסה.

    כניסה לדף Credentials

  2. בוחרים את מפתח ה-API שרוצים להגדיר עבורו הגבלה. הדף של נכס ה-API יופיע.
  3. בקטע הגבלות מפתח, מגדירים את ההגבלות הבאות:
    • הגבלות על אפליקציות:
      1. כדי לאשר בקשות מרשימת כתובות ה-IP של שרתי האינטרנט שאתם מספקים, בוחרים באפשרות כתובות IP (שרתי אינטרנט, משימות cron וכו') מתוך הרשימה הגבלות על אפליקציות. יש לציין כתובת IPv4 או IPv6 אחת או תת-רשת אחת באמצעות סימון CIDR (למשל: 192.168.0.0/22). מאחר שבקשה לשירותי אינטרנט בודקת את כתובת ה-IP החיצונית ומשווה אותה להגבלה של מפתח ה-API, צריך להשתמש בכתובת ה-IP הציבורית של השרת.
    • הגבלות API:
      1. לוחצים על Restrict key.
      2. בוחרים באפשרות Street View Static API בתפריט הנפתח Select APIs. אם Street View Static 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="street-view-image-backend.googleapis.com"
    --allowed-ips="IP_ADDRESS"

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

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

עליכם לכלול מפתח API עם כל בקשה ל-Street View Static API. בדוגמה הבאה עליך להחליף את YOUR_API_KEY במפתח ה-API שלך.

https://maps.googleapis.com/maps/api/streetview?location=41.403609,2.174448&size=456x456&key=YOUR_API_KEY

HTTPS נדרש לבקשות שמשתמשות במפתח API.

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

כמו כן, צריך להשתמש בחתימה דיגיטלית בחתימה דיגיטלית ב-Street View.