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

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

עלויות

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

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

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

שלב 1

המסוף

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

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

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

    אנחנו מציעים תקופת ניסיון של 0.00 $ב-Google Cloud. תקופת הניסיון תסתיים באחת מ-90 השעות האחרונות ימים או אחרי שהחשבון צבר חיובים בסך 1,200 ש"ח, המוקדם מביניהם. לא, התחרטתי בכל שלב. הפלטפורמה של מפות 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.
    תיבת הדו-שיח 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 ועל הפקודות הבאות:

יצירת iframe

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

בדיקת ה-iframe

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

  1. פותחים את הכלי לעריכת טקסט שמוגדר כברירת מחדל. צריכים להיות לכם כלי עריכה של טקסט, כמו TextEdit או Notepad של Microsoft Windows במכשיר שלך כברירת מחדל.
  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.

השלבים הבאים

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

    הגדרה במסוף Cloud

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

    הטמעת מפה

  • הרחבת הפרויקט שלכם במפות Google באמצעות ממשק ה-API של JavaScript:

    Maps Javascript API