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

קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.
בחירת פלטפורמה: Android iOS JavaScript שירות אינטרנט

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

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

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

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

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

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

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

https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=-33.8670522,151.1957362&radius=500&types=restaurant&name=harbour&key=YOUR_API_KEY

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