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