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

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

עלויות

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

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

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

שלב 1

המסוף

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

    לדף בורר הפרויקטים

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

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

Cloud SDK

gcloud projects create "PROJECT"

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

שלב 2

כדי להשתמש בפלטפורמה של מפות Google, עליכם להפעיל את ממשקי ה-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 > פרטי כניסה.

    כניסה לדף Credentials

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

יצירת 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 בדפדפן אינטרנט, גוררים אותו משולחן העבודה לדפדפן. לחלופין, לחיצה כפולה על הקובץ פועלת ברוב מערכות ההפעלה.

מזל טוב! כל מה שצריך לעשות הוא להגדיר ולבנות מפה באמצעות ממשק ה-API של מפות Google להטמעה.

מנקה

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

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

    כניסה לדף Manage resources

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

השלבים הבאים