בדף הזה מפורטים השלבים הבסיסיים הנדרשים כדי להתחיל להשתמש באחד מממשקי ה-API וערכות ה-SDK בפלטפורמה של מפות Google.
מדריך למתחילים
אם אף פעם לא השתמשתם במסוף Google Cloud כדי ליצור חשבון לחיוב או פרויקט, לוחצים על הלחצן Get Started (תחילת העבודה) שמקשר אל חוויית הגדרה אינטראקטיבית במסוף Cloud למשתמשים חדשים:
קדימה, מתחיליםאפשר גם ללחוץ על הכרטיסיות הבאות כדי להשלים את שלבי ההגדרה הנדרשים:
שלב 1
המסוף
-
במסוף Google Cloud, בדף לבחירת הפרויקט לוחצים על Create Project כדי ליצור פרויקט חדש ב-Cloud.
-
הקפידו לוודא שהחיוב מופעל בפרויקט שלכם ב-Cloud. מוודאים שהחיוב מופעל בפרויקט.
ב-Google Cloud יש תקופת ניסיון ללא תשלום. תוקף תקופת הניסיון יפוג אחרי 90 יום או אחרי שיצטברו בחשבון חיובים בסך 300$, המוקדם מביניהם. אפשר לבטל בכל שלב. בפלטפורמה של מפות Google יש קרדיט חודשי קבוע בסך 200$. למידע נוסף, ראו זיכויים בחשבון לחיוב וחיוב.
Cloud SDK
gcloud projects create "PROJECT"
מידע נוסף על Google Cloud SDK, על התקנת Cloud SDK ועל הפקודות הבאות:
שלב 2
כדי להשתמש בפלטפורמה של מפות Google, צריך להפעיל את ממשקי ה-API או ערכות ה-SDK שבהם אתם מתכננים להשתמש בפרויקט.
חשוב לזכור שבשילובים מסוימים צריך להפעיל כמה ממשקי API או SDK. אם אתם לא בטוחים אילו ממשקי API או ערכות SDK צריך להפעיל, תוכלו להשתמש בבורר ממשקי ה-API או לעיין במסמכי התיעוד של ה-API או ה-SDK שבהם אתם רוצים להשתמש.
כדי להפעיל ממשק API או ערכת SDK אחד או יותר:
המסוף
-
כדי לראות את ערכות ה-SDK וממשקי ה-API של הפלטפורמה של מפות Google שאפשר להפעיל, נכנסים לדף ספריית API של מפות Google ב-Cloud Console:
- לוחצים על ה-API או ה-SDK שרוצים להפעיל.
- אם הכיתוב על הלחצן הוא ENABLE, לוחצים עליו כדי להפעיל את ה-API או את ה-SDK.
- אם הכיתוב על הלחצן הוא ניהול, ה-API או ה-SDK כבר מופעלים ואין צורך לבצע פעולה נוספת.
- לחיצה על אחד מהלחצנים תציג את לוח הבקרה של ה-API או ה-SDK. (לוחצים על הלחצן השבתה כדי להסיר את ה-API או ה-SDK מהפרויקט הזה.)
Cloud SDK
הפקודה הבאה מפעילה את כל ממשקי ה-API של מפות Google, מסלולים ומקומות:
gcloud services enable \ --project "PROJECT" \ "directions-backend.googleapis.com" \ "distance-matrix-backend.googleapis.com" \ "addressvalidation.googleapis.com" \ "tileaerialview.googleapis.com" \ "elevation-backend.googleapis.com" \ "routes.googleapis.com" \ "geocoding-backend.googleapis.com" \ "geolocation.googleapis.com" \ "maps-android-backend.googleapis.com" \ "maps-backend.googleapis.com" \ "maps-embed-backend.googleapis.com" \ "maps-ios-backend.googleapis.com" \ "mapsplatformdatasets.googleapis.com" \ "places-backend.googleapis.com" \ "roads.googleapis.com" \ "routeoptimization.googleapis.com" \ "static-maps-backend.googleapis.com" \ "street-view-image-backend.googleapis.com" \ "timezone-backend.googleapis.com"
מידע נוסף על Google Cloud SDK, על התקנת Cloud SDK ועל הפקודות הבאות:
משתמשים בפקודה הבאה כדי להפעיל את ממשקי ה-API של הסביבה:
gcloud services enable \ --project "PROJECT" \ "airquality.googleapis.com" \ "solar.googleapis.com" \ "pollen.googleapis.com"
שלב 3
בשלב הזה יתבצע רק תהליך היצירה של מפתח ה-API. אם משתמשים במפתח ה-API בסביבת הייצור, מומלץ מאוד להגביל את מפתח ה-API. מידע נוסף זמין בדף שימוש במפתחות 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 והפקודות הבאות:
זיכויים בחשבון לחיוב
אחרי שתיצרו חשבון לחיוב ופרויקט, תוכלו ליהנות מ-300 $ללא תשלום במסגרת תקופת הניסיון של Google Cloud Platform, ומהנחה חודשית קבועה של 200 $בפלטפורמה של מפות Google. מידע נוסף זמין במאמר זיכויים בחשבון לחיוב.
השלבים הבאים
אחרי שתסיימו את תהליך ההגדרה, תוכלו להתחיל להשתמש בערכות ה-SDK וממשקי ה-API של הפלטפורמה של מפות Google. מידע נוסף מופיע במדריכים הבאים: 'סקירה כללית', 'מפתחים' ו'תחילת העבודה' ל-API או ל-SDK שמעניינים אתכם. ממשקי ה-API וערכות ה-SDK מפורטים במאמרים מסמכי התיעוד של הפלטפורמה של מפות Google (לפי מוצר) וממשקי ה-API של הפלטפורמה של מפות Google (לפי פלטפורמה).