אפשר להציב בדף האינטרנט מפה אינטראקטיבית או פנורמה של Street View, באמצעות בקשת HTTP פשוטה — אין צורך ב-JavaScript.
עלויות
כל הבקשות ל-Maps Embed API זמינות ללא תשלום, ללא הגבלת שימוש. עם זאת, עדיין נדרש מפתח API תקין של Google Cloud לכל בקשה. מידע נוסף זמין במאמר שימוש וחיוב.
לפני שמתחילים
כדי ליצור מפה מוטמעת בדף האינטרנט, צריך לבצע את שלבי ההגדרה הנדרשים בלחיצה על הכרטיסיות הבאות:
שלב 1
המסוף
-
במסוף Google Cloud, בדף בורר הפרויקטים, לוחצים על Create Project כדי להתחיל ליצור פרויקט חדש ב-Cloud.
-
הקפידו לוודא שהחיוב מופעל בפרויקט שלכם ב-Cloud. מוודאים שהחיוב מופעל בפרויקט.
ב-Google Cloud יש תקופת ניסיון ללא תשלום. תוקף תקופת הניסיון יפוג אחרי 90 יום או אחרי שיצטברו בחשבון חיובים בסך 300$, המוקדם מביניהם. אפשר לבטל בכל שלב. הפלטפורמה של מפות Google כוללת זיכוי קבוע בסך 200 $מדי חודש. למידע נוסף, ראו זיכויים בחשבון לחיוב וחיוב.
Cloud SDK
gcloud projects create "PROJECT"
מידע נוסף על Google Cloud SDK, על התקנת Cloud SDK ועל הפקודות הבאות:
שלב 2
כדי להשתמש בפלטפורמה של מפות Google, צריך להפעיל את ממשקי ה-API או ערכות ה-SDK שבהם אתם מתכננים להשתמש בפרויקט.
המסוף
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:
המסוף
-
עוברים לדף פלטפורמת מפות Google > פרטי כניסה.
-
בדף Credentials, לוחצים על Create credentials > API key.
תיבת הדו-שיח API key created מציגה את מפתח ה-API החדש שיצרתם. -
לוחצים על סגירה.
מפתח ה-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:
- פותחים את כלי עריכת הטקסט שמוגדר כברירת מחדל. כלי עריכת טקסט כמו TextEdit או Microsoft Windows Notepad מותקנים במכשיר כברירת מחדל.
- יוצרים קובץ HTML ונותנים לו את השם
index.html
. מוסיפים את הקוד הבא עם ה-iframe שיצרתם למעלה:
<html> <!-- Replace this code comment with your iframe. --> </html>
שומרים את קובץ ה-HTML בפורמט
index.html
.כדי לטעון את קובץ ה-HTML בדפדפן אינטרנט, גוררים אותו מהמחשב לדפדפן. לחלופין, אפשר ללחוץ לחיצה כפולה על הקובץ ברוב מערכות ההפעלה.
מזל טוב! כל מה שצריך לעשות הוא להגדיר ולבנות מפה באמצעות ממשק ה-API של מפות Google להטמעה.
ניקוי
אתם יכולים למחוק את הפרויקט ב-Google Cloud כדי להפסיק את החיוב על כל המשאבים שבהם אתם משתמשים באותו פרויקט.
- נכנסים לדף Manage resources במסוף Google Cloud:
- אם הפרויקט שרוצים למחוק מחובר לארגון, בוחרים את רשימת הארגונים בחלק העליון של הדף ומרחיבים אותה.
- ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
- כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.
השלבים הבאים
כדי להתחיל לפתח באמצעות Maps Embed API, צריך להגדיר את הפרויקט ב-Google Cloud:
רשימה של פרמטרים ואפשרויות נוספים שאפשר להוסיף ב-iframe:
הרחבת הפרויקט שלכם במפות Google באמצעות ממשק ה-API של JavaScript: