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

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

עלויות

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

המסוף

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

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

מנקה

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

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

    כניסה לדף Manage resources

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

השלבים הבאים