תחילת העבודה עם הפלטפורמה של מפות Google

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

מדריך למתחילים

אם אף פעם לא השתמשתם במסוף Google Cloud כדי ליצור חשבון לחיוב או פרויקט, לוחצים על הלחצן Get Started (תחילת העבודה) שמקשר לחוויית הגדרה אינטראקטיבית במסוף Cloud למשתמשים חדשים:

תחילת העבודה

לחלופין, אפשר להשלים את שלבי ההגדרה הנדרשים בלחיצה על הכרטיסיות הבאות:

שלב 1שלב 2שלב 3
המסוףCloud SDK

  1. במסוף Google Cloud, בדף לבחירת הפרויקט לוחצים על Create Project כדי ליצור פרויקט חדש ב-Cloud.

    כניסה לדף לבחירת הפרויקט

  2. הקפידו לוודא שהחיוב מופעל בפרויקט שלכם ב-Cloud. מוודאים שהחיוב מופעל בפרויקט.

    ב-Google Cloud יש תקופת ניסיון ללא תשלום. תוקף תקופת הניסיון יפוג אחרי 90 יום או אחרי שיצטברו בחשבון חיובים בסך 300$, המוקדם מביניהם. תמיד אפשר לבטל. בפלטפורמה של מפות Google יש קרדיט חודשי קבוע בסך 200$. למידע נוסף, ראו זיכויים בחשבון לחיוב וחיוב. 

gcloud projects create "PROJECT"

מידע נוסף על Google Cloud SDK, על התקנת Cloud SDK ועל הפקודות הבאות:

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

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

כדי להפעיל ממשק API או ערכת SDK אחת או יותר:

המסוףCloud SDK

  1. בדף Maps API Library במסוף Cloud תוכלו לראות את ממשקי ה-API וערכות ה-SDK של הפלטפורמה של מפות Google שאפשר להפעיל:

    נכנסים לדף ספריית Maps API

  2. לוחצים על ה-API או ה-SDK שרוצים להפעיל.
    • אם הלחצן כתוב ENABLE, לוחצים עליו כדי להפעיל את ה-API או את ה-SDK.
    • אם הכיתוב על הלחצן הוא ניהול, ה-API או ה-SDK כבר מופעלים ואין צורך לבצע פעולה נוספת.
    • לחיצה על אחד מהלחצנים תציג את לוח הבקרה של ה-API או ה-SDK. (לוחצים על הלחצן DISABLE כדי להסיר את ה-API או את ה-SDK מהפרויקט הזה).

הפקודה הבאה מפעילה את כל ממשקי ה-API של מפות Google, מסלולים ומקומות:

gcloud services enable \
    --project "PROJECT" \
    "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"

בשלב הזה מתוארת רק תהליך היצירה של מפתח ה-API. אם אתם משתמשים במפתח ה-API בסביבת הייצור, מומלץ מאוד להגביל את מפתח ה-API. מידע נוסף זמין בדף שימוש במפתחות API שספציפי למוצר.

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

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

המסוף Cloud SDK

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

    כניסה לדף Credentials

  2. בדף Credentials, לוחצים על Create credentials > API key.
    תיבת הדו-שיח API key created מציגה את מפתח ה-API החדש שיצרתם.
  3. לוחצים על סגירה.
    מפתח ה-API החדש מופיע בדף Credentials בקטע API keys.
    (חשוב לזכור להגביל את מפתח ה-API לפני שמשתמשים בו בסביבת הייצור). 
gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

מידע נוסף על Google Cloud SDK, על התקנת Cloud SDK ועל הפקודות הבאות:

זיכויים בחשבון לחיוב

אחרי שיוצרים חשבון לחיוב ופרויקט, אפשר ליהנות מ-300$ בחינם במסגרת תקופת הניסיון של Google Cloud. כל מק"ט של הפלטפורמה של מפות Google מספק כמות ספציפית של שימוש חודשי בחינם, כפי שמופיע ברשימת המחירים ומתואר בחיוב בפלטפורמה של מפות Google. Google מספקת גם זיכויים לתוכניות ציבוריות, כמו עמותות, חברות סטארט-אפ, תוכניות תגובה למקרי חירום, כלי תקשורת חדשותיים, מוסדות חינוך וחברות תחבורה ציבורית.

השלבים הבאים

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