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

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

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

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

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

לפני שמתחילים להשתמש ב-API של קידוד גיאוגרפי, צריך להפעיל פרויקט עם חשבון לחיוב וממשק ה-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. בוחרים באפשרות API לקידוד גיאוגרפי מהתפריט הנפתח בחירת ממשקי API. אם Geocoding 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="geocoding-backend.googleapis.com"
    --allowed-ips="IP_ADDRESS"

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

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

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

https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY

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