קבלת מפתח API

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

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

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

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

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

המסוף

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

    כניסה לדף Credentials

  2. בדף Credentials, לוחצים על Create credentials > API key.
    תיבת הדו-שיח מפתח API שנוצר מציגה את מפתח ה-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 ל-iOS בתפריט הנפתח Select APIs. אם ה-SDK של מפות Google ל-iOS לא מופיע ברשימה, עליך enable אותו.
  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 של Maps SDK ל-iOS, תוכלו להתחיל לעבוד.

מה עושים אחר כך

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