קבלת מפתח API

בחירת פלטפורמה: Android iOS JavaScript

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

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

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

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

המסוף

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

    כניסה לדף Credentials

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

Cloud SDK

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

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

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

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

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

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

המסוף

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

    כניסה לדף Credentials

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

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

עכשיו, אחרי שקיבלת את מפתח ה-API ל-SDK של מפות Google ל-iOS, אפשר להתחיל.

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

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