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