המדריך למתחילים של Maps Embed API

אפשר להציב מפה אינטראקטיבית או פנורמה ב-Street View בדף אינטרנט באמצעות בקשת HTTP פשוטה – לא נדרש JavaScript בהתאמה אישית.

עלויות

כל הבקשות ל-Maps Embed API זמינות ללא תשלום, עם שימוש ללא הגבלה. עם זאת, עדיין נדרש מפתח Google Cloud API תקין לכל הבקשות. מידע נוסף זמין במאמר בנושא שימוש וחיוב.

לפני שמתחילים

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

שלב 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 Maps Platform, צריך להפעיל את ממשקי ה-API או ערכות ה-SDK שמתכננים להשתמש בהם בפרויקט.

המסוף

הפעלת Maps Embed API

Cloud SDK

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

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

שלב 3

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

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

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

המסוף

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

    לדף 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 ועל הפקודות הבאות:

יצירת iframe

לוחצים על האפשרויות הבאות ומוסיפים מיקום ומפתח API כדי ליצור iframe לדף האינטרנט. פרמטרים ואפשרויות נוספים מפורטים במאמר בנושא הטמעת מפה.

בדיקת ה-iframe

כדי לראות את ה-iframe בחלון דפדפן HTML:

  1. פותחים את הכלי לעריכת טקסט שמוגדר כברירת מחדל. במכשיר שלכם אמורות להיות מותקנות כברירת מחדל תוכנות לעריכת טקסט כמו TextEdit או Microsoft Windows Notepad.
  2. יוצרים קובץ HTML ונותנים לו את השם index.html.

  3. מוסיפים את הקוד הבא עם ה-iframe שנוצר בשלב הקודם:

    <html>
  <!-- Replace this code comment with your iframe. -->
</html>

  4. שומרים את קובץ ה-HTML‏ index.html.

  5. טוענים את קובץ ה-HTML בדפדפן אינטרנט על ידי גרירתו מהמחשב אל הדפדפן. לחלופין, אפשר ללחוץ לחיצה כפולה על הקובץ ברוב מערכות ההפעלה.

מזל טוב! הרגע הגדרתם ויצרתם מפה באמצעות Maps Embed API.

סידור וארגון

אתם יכולים למחוק את הפרויקט שלכם ב-Google Cloud כדי להפסיק את החיוב על כל המשאבים שנעשה בהם שימוש במסגרת הפרויקט.

  1. במסוף Google Cloud, נכנסים לדף Manage resources:

    כניסה לדף Manage resources

  2. אם הפרויקט שרוצים למחוק מחובר לארגון, בוחרים את רשימת הארגונים בחלק העליון של הדף ומרחיבים אותה.
  3. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
  4. כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.

השלבים הבאים

  • כדי להתחיל לפתח באמצעות Maps Embed API, צריך להגדיר את פרויקט בענן ב-Google Cloud:

    הגדרה במסוף Cloud

  • רשימה של פרמטרים ואפשרויות נוספים שאפשר להוסיף ל-iframe:

    הטמעת מפה

  • הרחבת פרויקט מפות באמצעות JavaScript API:

    ‫Maps JavaScript API