לפני שמתחילים
לפני שמתחילים להשתמש ב-Places SDK ל-iOS, צריך פרויקט עם חשבון לחיוב ועם Places SDK ל-iOS מופעל. מידע נוסף זמין במאמר הגדרה במסוף Cloud.
יצירת מפתחות API
מפתח ה-API הוא מזהה ייחודי שמאמת בקשות המשויכות לפרויקט שלכם לצורכי שימוש וחיובים. צריך להיות לפחות מפתח API אחד שמשויך לפרויקט.
כך יוצרים מפתח API:
המסוף
-
עוברים לדף פלטפורמת מפות Google > פרטי כניסה.
-
בדף Credentials, לוחצים על Create credentials > API key.
תיבת הדו-שיח API key created מציגה את מפתח ה-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
Google ממליצה מאוד להגביל את מפתחות ה-API על ידי הגבלת השימוש בהם רק לממשקי ה-API הנחוצים לאפליקציה. הגבלת מפתחות ה-API מוסיפה אבטחה לאפליקציה על ידי הגנה עליה מפני בקשות לא רצויות. אתם אחראים על החיובים שנגרמו כתוצאה משימוש לרעה במפתחות API ללא הגבלה. למידע נוסף, ראו שיטות מומלצות לאבטחת API.
כדי להגביל מפתח API:
המסוף
-
עוברים לדף פלטפורמת מפות Google > פרטי כניסה.
- בוחרים את מפתח ה-API שרוצים להגדיר לו הגבלה. יופיע הדף של נכס מפתח ה-API.
- בקטע Key restrictions, מגדירים את ההגבלות הבאות:
- הגבלות על אפליקציות:
- בוחרים באפשרות אפליקציות ל-iOS.
- כדי לקבל בקשות מהאפליקציה ל-iOS עם מזהה החבילה שסיפקתם, בוחרים מהרשימה את מזהה החבילה המתאים ל-iOS.
- הגבלות על ממשקי API:
- לוחצים על Restrict key.
- בוחרים באפשרות Places API בתפריט הנפתח Select APIs. אם Places API לא מופיע ברשימה, צריך להפעיל אותו.
- כדי לסיים את השינויים, לוחצים על שמירה.
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/locations/global/keys/KEY_ID \ --api-target=service=places-backend.googleapis.com --allowed-bundle-ids="BUNDLE_NAME"
מידע נוסף על Google Cloud SDK, על התקנת Cloud SDK ועל הפקודות הבאות: