קבלת מפתח API

בחירת פלטפורמה: Android iOS JavaScript Web Service
מפתחים באזור הכלכלי האירופי (EEA)

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

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

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

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

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

המסוף

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

    מעבר לדף Credentials

  2. בדף Credentials, לוחצים על Create credentials > API key.
    בתיבת הדו-שיח 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

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

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

המסוף

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

    מעבר לדף Credentials

  2. בוחרים את מפתח ה-API שרוצים להגביל. יופיע דף המאפיינים של מפתח ה-API.
  3. בקטע Key restrictions (הגבלות על מפתחות), מגדירים את ההגבלות הבאות:
    • הגבלות על אפליקציות:
      1. בוחרים באפשרות אפליקציות ל-iOS.
      2. כדי לאשר בקשות מהאפליקציה ל-iOS עם מזהה החבילה שציינתם, בוחרים את מזהה החבילה המתאים ל-iOS מהרשימה.
    • הגבלות על ממשקי API:
      1. לוחצים על Restrict key.
      2. בתפריט הנפתח Select APIs (בחירת ממשקי API) בוחרים באפשרות Places API and/or Places API (New) (ממשק Places API ו/או ממשק Places API (חדש)). אם Places API או Places API (חדש) לא מופיעים ברשימה, צריך להפעיל אותם.
  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=places-backend.googleapis.com
    --allowed-bundle-ids="BUNDLE_NAME"

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

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

אחרי שיצרתם מפתח API, אתם צריכים ליצור ולהגדיר פרויקט כמו שמתואר במאמר הגדרת פרויקט Xcode.