מדריך מקוצר ל-Maps Embed API

‫Maps Embed API מציב מפה אינטראקטיבית או פנורמה ב-Street View בדף אינטרנט באמצעות בקשת HTTP שמוגדרת ככתובת URL של iframe src, בלי צורך ב-JavaScript. הוא תומך במצבי המפה place,‏ view,‏ directions,‏ streetview ו-search.

‫Maps Embed API: עובדות חשובות

  • מוצר: Maps Embed API
  • שמות נוספים: Google Maps Embed API, ‏Maps Embed
  • קטגוריה: מפות Google
  • פלטפורמה: JavaScript (דפדפן)
  • פועל ב: לקוח (קוד של אפליקציה או דפדפן)
  • שלב ההשקה: GA
  • מחזור חיים: פעיל
  • סקירה כללית: סקירה כללית על Maps Embed API
  • זמינות אזורית: גלובלית. מצב Street View תלוי בכיסוי של Street View. הפרמטר region מקבל אזורים שרשומים בדף הפרטים של הכיסוי בפלטפורמה של מפות Google. (פרטי הכיסוי)

‫Maps Embed API: מתי כדאי להשתמש בו

מתי כדאי להשתמש ב-Maps Embed API:

  • אתם צריכים מפה אינטראקטיבית או פנורמה ב-Street View בדף אינטרנט, באמצעות iframe ב-HTML בלבד, בלי JavaScript.
  • אתם צריכים להציג סיכת מיקום, תצוגת מפה, מסלול בין נקודות או תוצאות חיפוש של אזור במפה מוטמעת.
  • אתם צריכים מפה מוטמעת ללא חיוב לכל בקשה וללא מכסות של QPS או בקשות יומיות (עדיין נדרש מפתח API).

מתי לא כדאי להשתמש ב-Maps Embed API:

  • אתם צריכים להתאים אישית מפה באינטרנט עם תוכן ותמונות משלכם. במקום זאת, צריך להשתמש ב-Maps JavaScript API.
  • אתם צריכים להרחיב מפה מוטמעת באמצעות תכונות פרוגרמטיות מעבר לפרמטרים של כתובת ה-URL של iframe. במקום זאת, צריך להשתמש ב-Maps JavaScript API.

‫Maps Embed API: הגדרה

‫Maps Embed API: טעויות נפוצות

  • הבעיה: אם בדף המארח מוגדר מטא תג referrer ל-no-referrer או ל-same-origin, הדפדפן לא שולח את הכותרת Referer, ומפתח API שמוגבל לגורמים מפנים מסוג HTTP יכול לדחות את בקשות ההטמעה. הפתרון: מוסיפים את referrerpolicy="strict-origin-when-cross-origin" ל-iframe כדי שהדומיין של האתר יישלח אל Google. למידע נוסף, אפשר לעיין במאמר /maps/documentation/embed/embedding-map.
  • הבעיה: מפות מוטמעות לא נתמכות אם אחד מהממדים שלהן קטן מ-200 פיקסלים. הפתרון: מגדירים את ה-width וה-height של ה-iframe ל-200 פיקסלים לפחות. למידע נוסף, אפשר לעיין במאמר /maps/documentation/embed/embedding-map.
  • הבעיה: למרות שהשימוש הוא ללא תשלום, מופיעה מפה כהה עם סימן מים "למטרות פיתוח בלבד" אם החיוב לא מופעל, אמצעי החיוב לא חוקי, חרגתם ממגבלה יומית שהגדרתם בעצמכם או שבבקשה חסר מקור הפניה ב-HTTP כשאתם משתמשים במפתח שמוגבל למקור הפניה. פתרון: מפעילים את החיוב בפרויקט באמצעות אמצעי תשלום תקין, מגדילים או מסירים את מגבלת המכסה היומית שהגדרתם בעצמכם, ומוודאים שהמפנה נשלח למפתחות שמוגבלים למפנה (לדוגמה, באמצעות referrerpolicy="strict-origin-when-cross-origin" ב-iframe). אפשר לעיין בכתובת /maps/documentation/embed/error-messages.
  • הבעיה: בבקשות לא תקינות (פרמטרים שגויים או חסרים, ושגיאות במפתח ה-API ובמכסות, כמו מפתח חסר או לא תקין, Maps Embed API לא מופעל או הפרה של הגבלת מפתח), רק קוד הסטטוס HTTP 4xx מדווח במסוף הדפדפן, ולא הודעה תיאורית. טקסט השגיאה מופיע בתוך ה-iframe במקום המפה. הפתרון: קוראים את טקסט השגיאה ב-iframe ואת קוד הסטטוס במסוף (400 לשגיאות בפרמטרים, 401 למפתח חסר, 403 למפתח לא תקין), ואז מוודאים שהפרמטרים תקינים, שהמפתח תקין, ש-Maps Embed API מופעל ושההגבלות על המפתח מאפשרות את הבקשה. אפשר לעיין בכתובת /maps/documentation/embed/error-messages.

מה אפשר לעשות עם Maps Embed API

במדריכים שמקושרים בהמשך מפורטות כל המשימות, ואפשר גם להשוות בין המוצרים בסייר היכולות.

‫Maps Embed API: מסלולים וניווט

‫Maps Embed API: מפות

‫Maps Embed API: מקומות

‫Maps Embed API: Street View