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

Cloud SDK

gcloud projects create "PROJECT"

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

• gcloud projects create

שלב 2: מפעילים את ממשקי ה-API או ערכות ה-SDK

כדי להשתמש ב-Google Maps Platform, צריך להפעיל את ממשקי ה-API או ערכות ה-SDK שבהם אתם מתכוונים להשתמש בפרויקט.

המסוף

הפעלת Maps Embed API

Cloud SDK

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-backend.googleapis.com"

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

• gcloud services enable
• gcloud services disable

שלב 3: קבלת מפתח API

השלב הזה מתייחס רק לתהליך היצירה של מפתח ה-API. אם אתם משתמשים במפתח ה-API בסביבת הייצור, מומלץ מאוד להגביל את מפתח ה-API. מידע נוסף זמין בדף שימוש במפתחות API הספציפי למוצר.

מפתח ה-API הוא מזהה ייחודי שמאמת בקשות שמשויכות לפרויקט שלכם למטרות שימוש וחיוב. צריך להיות לפחות מפתח API אחד שמשויך לפרויקט.

כך יוצרים מפתח API:

המסוף

1. נכנסים לדף Google Maps Platform > Credentials.

   כניסה לדף Credentials

2. בדף Credentials, לוחצים על Create credentials > מפתח API.
   בתיבת הדו-שיח API key created מוצג מפתח ה-API החדש שיצרתם.
3. לוחצים על סגירה.
   מפתח ה-API החדש מופיע בדף Credentials בקטע API keys.
   (חשוב לזכור להגביל את מפתח ה-API לפני שמשתמשים בו בסביבת הייצור).

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

• gcloud services api-keys create

יצירת 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. ברשימת הפרויקטים, בוחרים את הפרויקט שרוצים למחוק ולוחצים על Delete.
4. כדי למחוק את הפרויקט, כותבים את מזהה הפרויקט בתיבת הדו-שיח ולוחצים על Shut down.

השלבים הבאים

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

  הגדרה במסוף Cloud

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

  הטמעת מפה

• הרחבת הפרויקט במפות Google באמצעות JavaScript API:

  Maps JavaScript API