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

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

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

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

תחילת העבודה

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

שלב 1

המסוף

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

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

  2. הקפידו לוודא שהחיוב מופעל בפרויקט שלכם ב-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 אחת או יותר:

המסוף

  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" \
    "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:

המסוף

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

    כניסה לדף Credentials

  2. בדף Credentials, לוחצים על Create credentials > API key.
    תיבת הדו-שיח API key created מציגה את מפתח ה-API החדש שיצרתם.
  3. לוחצים על סגירה.
    מפתח ה-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. מידע נוסף זמין במאמר זיכויים בחשבון לחיוב.

השלבים הבאים

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