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

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

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

אם אף פעם לא השתמשתם במסוף 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: מפעילים את ממשקי ה-API או ערכות ה-SDK

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

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

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

המסוף

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

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

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

Cloud SDK

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

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" \
    "weather.googleapis.com"

שלב 3: קבלת מפתח API

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

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

המסוף

  1. נכנסים לדף Google Maps Platform > Keys & Credentials.

    כניסה לדף Keys & Credentials

  2. אם מתבקשים, בוחרים את הפרויקט.

  3. מבצעים אחת מהפעולות האלה:

    • יצירת מפתח חדש:

      1. לוחצים על Create credentials > מפתח API.
      2. בחלונית יצירת מפתח API, פותחים את הרשימה בחירת הגבלות API.
      3. מבטלים את הבחירה בממשקי ה-API שהמפתח לא צריך, ומוודאים שממשקי ה-API שבהם רוצים להשתמש נשארים מסומנים.
      4. לוחצים על יצירה. בחלונית מוצג מפתח ה-API החדש.

    • שימוש במפתח קיים:

      1. לוחצים על שם המפתח.
      2. ברשימה Select API restrictions, בוחרים את ממשקי ה-API שבהם רוצים להשתמש.
      3. לוחצים על שמירה.

    בחירת API כאן לא מפעילה אותו. חשוב לוודא שכל ממשק API שבוחרים מופעל בספריית ה-API.

  4. כדי לראות את מחרוזת המפתח מאוחר יותר, עוברים לדף Keys & Credentials ולוחצים על Show key ליד המפתח.

אם המסוף נראה שונה מהשלבים האלה, עיינו במאמרים יצירת מפתח API והוספת הגבלות על API במסמכי התיעוד של Google Cloud.

Cloud SDK

בפקודות הבאות, מחליפים את PROJECT_ID במזהה הפרויקט.

  • יצירת מפתח חדש: מריצים את הפקודה הבאה ומחליפים את DISPLAY_NAME בשם של המפתח. מחליפים את SERVICE_NAME בשם השירות של ה-API שבו רוצים להשתמש, למשל places.googleapis.com. כדי לאפשר ממשקי API נוספים, חוזרים על הדגל --api-target.

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=SERVICE_NAME

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

  • שימוש במפתח קיים: מריצים את הפקודה הבאה ומחליפים את KEY_ID במזהה המפתח. מחליפים את SERVICE_NAME בשם השירות של ה-API שרוצים להוסיף. הדגל --append שומר על ממשקי ה-API שהמפתח כבר מאפשר. בלעדיו, הפקודה מחליפה אותם.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=SERVICE_NAME

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

    מזהה המפתח הוא לא מחרוזת המפתח או השם המוצג. כדי למצוא אותו, מריצים את הפקודה gcloud services api-keys list --project="PROJECT_ID". המזהה הוא החלק האחרון בשדה name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

כדי לראות את מחרוזת המפתח, מריצים את הפקודה gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

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

השלבים הבאים

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