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

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

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

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

תחילת העבודה

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

שלב 1

המסוף

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

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

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

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

Cloud SDK

gcloud projects create "PROJECT"

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

שלב 2

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

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

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

המסוף

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

    נכנסים לדף Maps API Library

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

Cloud SDK

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

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.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:

המסוף

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

    כניסה לדף Credentials

  2. בדף Credentials, לוחצים על Create credentials > API key.
    תיבת הדו-שיח API key created מציגה את מפתח ה-API החדש שיצרתם.
  3. לוחצים על סגירה.
    מפתח ה-API החדש מופיע בדף Credentials בקטע API keys.
    (חשוב להגביל את מפתח ה-API לפני שמשתמשים בו בסביבת הייצור).

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

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

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

השלבים הבאים

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