שנתחיל?

מבוא

בעזרת כתובות ה-URL של מפות Google אפשר ליצור כתובת URL אוניברסלית מפלטפורמות שונות כדי להפעיל את מפות Google ולבצע חיפושים, לקבל מסלולי ניווט ולהציג תצוגות של מפות ותמונות פנורמיות. התחביר של כתובות URL זהה, בלי קשר לפלטפורמה שבה משתמשים.

אין צורך במפתח Google API כדי להשתמש בכתובות URL של מפות Google.

תחביר אוניברסלי חוצה פלטפורמות

כשאתם מפתחים של אפליקציה ל-Android, אפליקציה ל-iOS או אתר, אתם יכולים ליצור כתובת URL משותפת, ואז לפתוח את מפות Google ולבצע את הפעולה המבוקשת, בלי קשר לפלטפורמה שבה האפליקציה נפתחת בזמן פתיחת המפה.

  • במכשיר Android:
    • אם אפליקציית מפות Google ל-Android מותקנת ופעילה, כתובת ה-URL מפעילה את מפות Google באפליקציה מפות Google ומבצעת את הפעולה המבוקשת.
    • אם האפליקציה מפות Google לא מותקנת או מושבתת, כתובת ה-URL מפעילה את מפות Google בדפדפן ומבצעת את הפעולה המבוקשת.
  • במכשיר iOS:
    • אם מותקנת אפליקציית מפות Google ל-iOS, כתובת ה-URL תפעיל את מפות Google באפליקציה מפות Google ותבצע את הפעולה המבוקשת.
    • אם האפליקציה מפות Google לא מותקנת, כתובת ה-URL מפעילה את מפות Google בדפדפן ומבצעת את הפעולה המבוקשת.
  • בכל מכשיר אחר, כתובת ה-URL מפעילה את מפות Google בדפדפן ומבצעת את הפעולה המבוקשת.

מומלץ להשתמש בכתובת URL מפלטפורמות שונות כדי להפעיל את מפות Google מהאפליקציה או מהאתר, כי זו כתובת URL אוניברסלית שמאפשרת טיפול רחב יותר בבקשות למפות מכל הפלטפורמות. לגבי תכונות שעשויות לפעול רק בפלטפורמה לנייד (לדוגמה, ניווט במסלול מפורט), ייתכן שתעדיפו להשתמש בפלטפורמה ספציפית ל-Android או ל-iOS. כדאי לעיין במסמכים הבאים:

הפעלת מפות Google וביצוע פעולה ספציפית

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

  • חיפוש — הפעלת מפה של Google שמציגה סיכה של מקום ספציפי, או ביצוע חיפוש כללי והפעלת מפה להצגת התוצאות:
    https://www.google.com/maps/search/?api=1&parameters
  • מסלול — בקשת מסלול והפעלת מפות Google עם התוצאות:
    https://www.google.com/maps/dir/?api=1&parameters
  • הצגת מפה — הפעלת מפות Google ללא סמנים או מסלולים:
    https://www.google.com/maps/@?api=1&map_action=map&parameters
  • הצגת פנורמה של Street View — הפעלת תמונה פנורמית אינטראקטיבית:
    https://www.google.com/maps/@?api=1&map_action=pano&parameters

חשוב: הפרמטר api=1 מזהה את הגרסה של כתובות ה-URL של מפות Google שעבורה מיועדת כתובת ה-URL הזו. הפרמטר הזה נדרש בכל בקשה. הערך החוקי היחיד הוא 1. אם הקטע api=1 לא מופיע בכתובת ה-URL, המערכת תתעלם מכל הפרמטרים ואפליקציית ברירת המחדל של מפות Google תופעל בדפדפן או באפליקציה לנייד של מפות Google, בהתאם לפלטפורמה שבה נעשה שימוש (לדוגמה, https://www.google.com/maps).

בניית כתובות URL חוקיות

יש לקודד בצורה נכונה כתובות URL.

לדוגמה, חלק מהפרמטרים משתמשים בתו צינור (|) כמפריד, שיש לקודד בתור %7C בכתובת ה-URL הסופית. פרמטרים אחרים משתמשים בערכים המופרדים בפסיקים, כמו קואורדינטות של קווי אורך ורוחב או עיר, מדינה. צריך לקודד את הפסיק כ-%2C. קידוד רווחים באמצעות %20, או החלפה שלהם בסימן חיבור (+).

בנוסף, בכל בקשה אפשר להזין עד 2,048 תווים. חשוב להביא בחשבון את המגבלה הזו בעת יצירת כתובות ה-URL.

פעולות במפה

פעולות המפה הזמינות הן: חיפוש, מסלול, הצגת מפה והצגת פנורמה ב-Street View. יש לציין את הפעולה בכתובת ה-URL של הבקשה, יחד עם פרמטרים נדרשים ואופציונליים. כמו בכל כתובת URL, יש להפריד בין הפרמטרים באמצעות התו אמפרסנד (&). עבור כל פעולה, רשימת הפרמטרים והערכים האפשריים שלהם נספרים בקטע פרמטרים של חיפוש.

חיפוש

פעולת החיפוש מציגה תוצאות לחיפוש באזור המפה המוצג. כשמחפשים מקום ספציפי, המפה שמתקבלת מציבה סיכה במיקום שצוין ומציגה את פרטי המקום הזמינים.

יצירת כתובת URL לחיפוש

https://www.google.com/maps/search/?api=1&parameters

פרמטרים

  • query (חובה): מגדיר את המקומות המודגשים במפה. פרמטר השאילתה נדרש עבור כל בקשות החיפוש.
    • הגדרת מיקומים כשם, כתובת או קואורדינטות של קווי אורך ורוחב מופרדים בפסיקים מחרוזות צריכות להיות מקודדות בכתובות URL, כך שצריך להמיר כתובת כמו "City City, New York, NY" ל- City+Hall%2C+New+York%2C+NY.
    • יש לציין מונחי חיפוש כלליים כמחרוזת בקידוד כתובת URL, למשל grocery+stores או restaurants+in+seattle+wa.
  • query_place_id (אופציונלי): מזהה מקום הוא מזהה טקסט שמזהה מקום באופן ייחודי. עבור הפעולה search, יש לציין query, אבל אפשר לציין גם query_place_id. אם מציינים את שני הפרמטרים, משתמשים ב-query רק אם לא הצלחת למצוא את מזהה המקום במפות Google. אם ברצונך לקשר בבירור למוסד מסוים, מזהה המקום הוא הקישור הטוב ביותר למקום הנכון. בנוסף, מומלץ לשלוח query_place_id במהלך שאילתה של מיקום ספציפי באמצעות קואורדינטות של קווי אורך ורוחב.

דוגמאות לחיפוש

חיפוש מיקום

בחיפוש מיקום, אתם מחפשים מיקום ספציפי באמצעות שם מקום, כתובת או קואורדינטות של קווי אורך ורוחב מופרדים בפסיקים, והמפה שמתקבלת מציגה סיכה במיקום הזה. שלוש הדוגמאות האלו ממחישות חיפושים אחר מיקום זהה, CenturyLink (אצטדיון ספורט בסיאטל, וושינגטון), באמצעות ערכי מיקום שונים.

דוגמה 1: אם מחפשים את שם המקום "CenturyLink Field", הוא יופיע במפה הבאה:

https://www.google.com/maps/search/?api=1&query=centurylink+field

דוגמה 2: חיפוש השדה CenturyLink באמצעות קואורדינטות של קווי אורך ורוחב, וגם את מזהה המקום במפה הבאה:

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393&query_place_id=ChIJKxjxuaNqkFQR3CK6O1HNNqY

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

https://www.google.com/maps/search/?api=1&query=47.5951518%2C-122.3316393

חיפוש בקטגוריות

בחיפוש קטגורי, אתה מעביר מונח חיפוש כללי, ומפות Google מנסה למצוא רישומים שתואמים לקריטריונים שלך ליד המיקום שציינת. אם לא מצוין מיקום, מערכת מפות Google מנסה למצוא דפים עסקיים בקרבת מקום למיקום הנוכחי שלך. אם אתם מעדיפים לספק מיקום כדי לבצע חיפוש קטגורי, עליכם לכלול את המיקום במחרוזת החיפוש הכללית (לדוגמה, pizza+seattle+wa).

בדוגמה זו, חיפוש של פיצריות בסיאטל, וושינגטון, מניב את המפה הבאה:

https://www.google.com/maps/search/?api=1&query=pizza+seattle+wa


מסלול

פעולת מסלול מציגה את הנתיב בין שתי נקודות או יותר על המפה, וכן את המרחק וזמן הנסיעה.

יצירת כתובת אתר לקבלת מסלול

https://www.google.com/maps/dir/?api=1&parameters

פרמטרים

  • origin: נקודת ההתחלה שממנה יוצג המסלול. הגדרת ברירת המחדל היא מיקום ההתחלה הרלוונטי ביותר, כמו מיקום המכשיר, אם האפשרות זמינה. אם היא לא מופיעה, ייתכן שהמפה שתתקבל תספק טופס ריק שיאפשר למשתמש להזין את המקור. הערך יכול להיות שם של מקום, כתובת או קואורדינטות של קווי אורך ורוחב מופרדים בפסיקים. מחרוזת צריכה להיות מקודדת לפי כתובת אתר, כך שצריך להמיר כתובת כמו City City, New York, NY ל-City+Hall%2C+New+York%2C+NY.

    הערה: הפרמטר הזה הוא אופציונלי, אלא אם ציינת origin_place_id בכתובת ה-URL. כדי לציין origin_place_id, צריך לכלול גם origin בכתובת ה-URL.

  • origin_place_id (אופציונלי): מזהה מקום הוא מזהה טקסט שמזהה מקום באופן ייחודי. אם אתה מנסה לציין בבירור הקמת בית עסק, שימוש במזהה מקום הוא הערובה הטובה ביותר לקשר אל המקום הנכון. כתובות URL שמשתמשות בפרמטר הזה חייבות לכלול גם origin.
  • destination: הגדרת נקודת הקצה של המסלול. אם אין מפה, היא עשויה לספק טופס ריק שיאפשר למשתמש להזין את היעד. הערך יכול להיות שם של מקום, כתובת או קואורדינטות של קווי אורך ורוחב מופרדים בפסיקים. מחרוזת צריכה להיות מקודדת לפי כתובת אתר, כך שצריך להמיר כתובת כמו City City, New York, NY ל-City+Hall%2C+New+York%2C+NY.

    הערה: הפרמטר הזה הוא אופציונלי, אלא אם ציינת destination_place_id בכתובת ה-URL. כדי לציין destination_place_id, צריך לכלול גם destination בכתובת ה-URL.

  • destination_place_id (אופציונלי): מזהה מקום הוא מזהה טקסט שמזהה מקום באופן ייחודי. אם אתה מנסה לציין בבירור הקמת בית עסק, שימוש במזהה מקום הוא הערובה הטובה ביותר לקשר אל המקום הנכון. כתובות URL שמשתמשות בפרמטר הזה חייבות לכלול גם destination.
  • travelmode (אופציונלי): מגדיר את שיטת הנסיעה. האפשרויות הן driving, walking (עדיף שבילים להולכי רגל, מדרכות, אם זמינים), bicycling (נתיבים חוצים שבילי אופניים ורחובות מועדפים, אם יש), או transit. אם לא מציינים travelmode, אפליקציית מפות Google מציגה אחד או יותר מהמצבים הרלוונטיים ביותר למסלול ו/או להעדפות המשתמש שצוינו.
  • dir_action=navigate (אופציונלי): הפעלת ניווט במסלול מפורט או תצוגה מקדימה של מסלול אל היעד שצוין, בהתאם למקור הנתונים. אם המשתמש מציין מקור והוא לא קרוב למיקום הנוכחי של המשתמש, או אם המיקום הנוכחי של המכשיר לא זמין, המפה תפעיל תצוגה מקדימה של המסלול. אם המשתמש לא מציין מקור (במקרה זה, ברירת המחדל של המקור היא המיקום הנוכחי של המכשיר), או אם המקור קרוב למיקום הנוכחי של המשתמש, המפה מפעילה ניווט במסלול מפורט. חשוב לשים לב שהניווט לא זמין בכל המוצרים של מפות Google ו/או בין כל היעדים. במקרים כאלה, המערכת תתעלם מהפרמטר הזה.
  • waypoints: מציין מקום מתווך אחד או יותר לניתוב מסלולים בין origin לבין destination. אפשר לציין מספר ציוני דרך באמצעות קו אנכי (|) להפרדה בין מקומות (לדוגמה, Berlin,Germany|Paris,France). מספר ציוני הדרך המותרים משתנה לפי הפלטפורמה שבה הקישור נפתח, ועד 3 ציוני דרך שנתמכים בדפדפנים לנייד. ניתן לציין עד 9 ציוני דרך נתמכים בכל מקרה אחר. ציוני הדרך מוצגים במפה באותו הסדר שבו הם מופיעים בכתובת ה-URL. כל ציון דרך יכול להיות שם של מקום, כתובת או קואורדינטות של קווי אורך ורוחב מופרדים בפסיקים. מחרוזות צריכות להיות מקודדות בכתובות אתרים, כך שציוני דרך כגון "ברלין,גרמניה|פריז,צרפת" יש להמיר ל Berlin%2CGermany%7CParis%2CFrance.

    הערות:

    • אין תמיכה בציוני דרך בכל המוצרים של מפות Google. במקרים כאלה, המערכת תתעלם מהפרמטר הזה.
    • פרמטר זה הוא אופציונלי, אלא אם ציינת waypoint_place_ids בכתובת האתר. אם בחרת לציין waypoint_place_ids, עליך לכלול גם את waypoints בכתובת ה-URL.
  • waypoint_place_ids (אופציונלי): מזהה מקום הוא מזהה טקסט שמזהה מקום באופן ייחודי. התכונה Waypoint_place_ids מאפשרת לך לספק רשימה של מזהי מקומות שתואמים לרשימה של waypoints. מזהי מקומות צריכים להופיע באותו הסדר שבו הם מופיעים בציוני הדרך, ולהפריד ביניהם באמצעות הקו המפריד "|" ( מקודד בכתובת URL בתור %7C). אם ברצונך לציין בצורה מפורשת מוסדות ספציפיים, מזהי מקומות הם האפשרות הטובה ביותר לקשר למקומות הנכונים. כתובות URL שמשתמשות בפרמטר הזה חייבות לכלול גם את waypoints.

דוגמאות למסלול

כתובת ה-URL הבאה מפעילה מפה במצב מסלול ומספקת טופס שיאפשר למשתמש להזין את נקודת המוצא ואת היעד.

https://www.google.com/maps/dir/?api=1

הדוגמה הבאה משיקה מפה עם מסלולי רכיבה על אופניים ממחט החלל אל שוק פייק פלייס, בסיאטל, וושינגטון.

https://www.google.com/maps/dir/?api=1&origin=Space+Needle+Seattle+WA&destination=Pike+Place+Market+Seattle+WA&travelmode=bicycling

הדוגמה הבאה מציגה מפה עם מסלולי הליכה מ-Google בסידני שבאוסטרליה אל בניין המלכה ויקטוריה.

https://www.google.com/maps/dir/?api=1&origin=Google+Pyrmont+NSW&destination=QVB&destination_place_id=ChIJISz8NjyuEmsRFTQ9Iw7Ear8&travelmode=walking


הצגת מפה

פעולת המפה מחזירה מפה ללא סמנים או מסלול.

יצירת כתובת האתר של המפה

https://www.google.com/maps/@?api=1&map_action=map&parameters

פרמטרים

  • map_action=map (חובה): מציין את סוג תצוגת המפה להצגה. למפות Google ול-Street View יש את אותה נקודת קצה. כדי להבטיח שתוצג מפה, צריך לציין את map_action בתור map.
  • center (אופציונלי): מגדיר את מרכז חלון המפה, ומאשר קואורדינטות של קווי אורך ורוחב כערכים מופרדים בפסיקים (לדוגמה, -33.8569,151.2152).
  • zoom (אופציונלי): הגדרת רמת המרחק מהתצוגה של המפה. הערכים הקבילים הם מספרים שלמים שנעים בין 0 (כל העולם) ל-21 (מבנים נפרדים). המגבלה העליונה יכולה להשתנות בהתאם לנתוני המפה שזמינים במיקום שנבחר. ברירת המחדל היא 15.
  • basemap (אופציונלי): מגדיר את סוג המפה שתוצג. הערך יכול להיות roadmap (ברירת המחדל), satellite או terrain.
  • layer (אופציונלי): מגדיר שכבה נוספת להצגה במפה, אם קיימת. הערך יכול להיות אחת מהאפשרויות הבאות: none (ברירת מחדל), transit, traffic או bicycling.

דוגמאות למפות

כתובת ה-URL לדוגמה הזו משיקה מפת Google שמוגדרת כברירת מחדל, שמתמקדת במיקום הנוכחי של המשתמש.

https://www.google.com/maps/@?api=1&map_action=map

הדוגמה הבאה מציגה מפה שמתמקדת בקאטומבה, NSW, אוסטרליה (בכתובת -33.712206,150.311941), ומגדירה את הפרמטרים האופציונליים zoom ו-basemap.

https://www.google.com/maps/@?api=1&map_action=map&center=-33.712206%2C150.311941&zoom=12&basemap=terrain


הצגת פנורמה ב-Street View

צילום פנורמה מאפשר לצופה להציג תמונות Street View כפנורמות אינטראקטיביות. בכל תמונה פנורמית ב-Street View אפשר לראות תצוגה מלאה של 360 מעלות במקום אחד. התמונות מכילות 360 מעלות של תצוגה אופקית (סיבוב מלא) ו-180 מעלות של תצוגה אנכית (מזווית ישרה עד ישר). צילום הפנור מפעיל צופה שמעבד את הפנורמה שמתקבלת כעין עם מצלמה במרכז. אפשר לתפעל את המצלמה כדי לשלוט בזום ובכיוון המצלמה.

ב-Google Street View יש תצוגות פנורמיות של מיקומים ייעודיים מאזור הכיסוי שלו. זמינים גם תמונות פנורמיות שנתרמו על ידי משתמשים ואוספים מיוחדים של Street View.

יצירת כתובת URL של Street View

https://www.google.com/maps/@?api=1&map_action=pano&parameters

פרמטרים

  • map_action=pano (חובה): מציין את סוג התצוגה שרוצים להציג. למפות Google ול-Street View יש את אותה נקודת קצה. כדי להבטיח שתוצג פנורמה, יש לציין את action כ-pano.

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

  • viewpoint: הצופה מציג את התמונה הפנורמית הקרובה ביותר למיקום viewpoint, כשהוא מוגדר כקואורדינטות של קווי אורך ורוחב מופרדות בפסיקים (לדוגמה: 46.414382,10.013988). מכיוון שהתמונות של Street View מתעדכנות מדי פעם, ותמונות עשויות להיות מצולמות במתכונת שונה מעט בכל פעם, יכול להיות שהמיקום שלך יוצמד לפנורמיות אחרים בזמן עדכון התמונות.
  • pano: מזהה הפנורמה הספציפי של התמונה שתוצג. אם מציינים pano, אפשר לציין גם viewpoint. viewpoint ישמש רק אם ל'מפות Google' אין אפשרות למצוא את מזהה הפנורמה. אם השדה pano מוגדר אך לא נמצא, והשדה viewpoint מצוין לא, לא תוצג תמונה פנורמית. במקום זאת, אפליקציית מפות Google תיפתח במצב ברירת המחדל, ותציג מפה המבוססת על המיקום הנוכחי של המשתמש.

הפרמטרים הבאים של כתובת URL הם אופציונליים:

  • heading: מציין את כיוון המצפן של המצלמה במעלות בכיוון השעון מצפון. הערכים הקבילים הם בין -180 ל-360 מעלות. אם לא מופיעה, כותרת ברירת מחדל נבחרת על סמך נקודת המבט (אם צוינה) של השאילתה ועל סמך המיקום בפועל של התמונה.
  • pitch: מציין את הזווית, למעלה או למטה של המצלמה. גובה הצליל הוא במעלות מ--90 עד 90. ערכים חיוביים יגרמו לזווית המצלמה כלפי מעלה, ואילו ערכים שליליים יגרמו לזווית המצלמה כלפי מטה. ברירת המחדל של גובה צליל היא 0 על סמך מיקום המצלמה בזמן הצילום. לכן, גובה צליל 0 הוא לעיתים קרובות, אבל לא תמיד, אופקי. לדוגמה, סביר להניח שתמונה שצולמה על גבעה תציג גובה ברירת מחדל שאינו אופקי.
  • fov: קביעת שדה התצוגה האופקי של התמונה. שדה התצוגה מתבטא במעלות, בטווח של 10 - 100. ברירת המחדל היא 90. כשמדובר באזור תצוגה בגודל קבוע, שדה התצוגה נחשב לרמת הזום, כאשר מספרים קטנים יותר מציינים רמה גבוהה יותר של מרחק מתצוגה.

דוגמאות ל-Street View

שתי הדוגמאות הראשונות מציגות נוף פנורמי של מגדל אייפל. בדוגמה אחת, המערכת משתמשת רק ב-viewpoint עבור המיקום ומגדירה את הפרמטרים האופציונליים heading, pitch ו-fov. לשם השוואה, בדוגמה 2 נעשה שימוש במזהה pano וגם באותם הפרמטרים שהוגדרו בדוגמה הראשונה. בדוגמה השלישית מוצגת תמונה פנורמית בתוך מבנה.

דוגמה 1: שימוש ב-viewpoint בלבד לציון מיקום.

https://www.google.com/maps/@?api=1&map_action=pano&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

דוגמה 2: נעשה שימוש במזהה pano וגם במיקום viewpoint. המזהה pano מקבל קדימות על פני viewpoint. בדוגמה הזו, מזהה הפנורמה נמצא, והמערכת מתעלמת מה-viewpoint. חשוב לשים לב: התמונה הפנורמית שמוצגת עבור המזהה pano שונה במקצת וחדשה יותר מהתמונה שנמצאה בשימוש רק בviewpoint.

https://www.google.com/maps/@?api=1&map_action=pano&pano=tu510ie_z4ptBZYo2BGEJg&viewpoint=48.857832%2C2.295226&heading=-45&pitch=38&fov=80

דוגמה 3: מציגה פנורמה של החלק הפנימי של מסעדת Serastro בלונדון, בריטניה, עם מזהה פנורמה.

https://www.google.com/maps/@?api=1&map_action=pano&pano=4U-oRQCNsC6u7r8gp02sLA

איתור מזהה פנורמה

יש כמה שיטות למצוא את המזהה של תמונת פנורמה ספציפית.

דוגמאות נוספות

דוגמאות למסלולי נסיעה באמצעות ציוני דרך

הדוגמאות הבאות משיקות את מפות Google ומציגות מסלולי נסיעה מפריז, צרפת לשרבורג, בצרפת, בניתוב בין ציוני הדרך הבאים:

עיר, מדינהשם המקוםמזהה מקום
1. ורסאי, צרפת ארמון ורסאי ChIJdUyx15R95kcRj85ZX8H8OAU
2. שארטר, צרפת קתדרלת שארטר ChIJKzGHdEgM5EcR_OBTT3nQoEA
3. לה מאן, צרפת קתדרלת סנט ג'וליאן לה מאן ChIJG2LvQNCI4kcRKXNoAsPi1Mc
4. קאן, צרפת טירת קאן ChIJ06tnGbxCCkgRsfNjEQMwUsc

בכתובות ה-URL לדוגמה, ציוני הדרך מוגדרים בדרכים שונות כך שאפשר להשוות את ההבדלים בתצוגה של ציוני הדרך במפות המתקבלות.

דוגמה 1: ציוני דרך מוגדרים כעיר, ארץ:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance

דוגמה 2: ציוני דרך מוגדרים כשמות מקום ספציפיים:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Palace+of+Versailles%7CChartres+Cathedral%7CCathedral+of+Saint+Julian+of+Le+Mans%7CCaen+Castle

דוגמה 3: ציוני דרך מוגדרים כעיר ומדינה, וכן waypoint_place_ids עבור מוסד ספציפי בכל נקודת ציון:

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CChartres%2CFrance%7CLe+Mans%2CFrance%7CCaen%2CFrance&waypoint_place_ids=ChIJdUyx15R95kcRj85ZX8H8OAU%7CChIJKzGHdEgM5EcR_OBTT3nQoEA%7CChIJG2LvQNCI4kcRKXNoAsPi1Mc%7CChIJ06tnGbxCCkgRsfNjEQMwUsc

דוגמה 4: מגדיר ציוני דרך כעיר, מדינה, אך מפרט את ציוני הדרך בסדר שונה מהדוגמאות הקודמות. מראה שהמפה מציגה ציוני דרך לפי הסדר שבו הם רשומים בכתובת ה-URL.

https://www.google.com/maps/dir/?api=1&origin=Paris%2CFrance&destination=Cherbourg%2CFrance&travelmode=driving&waypoints=Versailles%2CFrance%7CCaen%2CFrance%7CLe+Mans%2CFrance%7CChartres%2CFrance

דוגמאות למפות

מציג מפה עם basemap (לוויין) ו-layer (תחבורה ציבורית).

https://www.google.com/maps/@?api=1&map_action=map&center=37.7992940%2C-122.3976113&zoom=15&basemap=satellite&layer=transit

דוגמאות ל-Street View

מציגה תמונת פנורמה של Street View באמצעות מפתח תמונה של FIFE כמזהה pano. יש לשים לב שהמזהה של pano מופיע לפני F:.

https://www.google.com/maps/@?api=1&map_action=pano&pano=F:-ud6AZSB-sQg/V0cfCSV3OWI/AAAAAAAAG1U/UQEoc5sXPQEIP7zzD6SWzmKb8Vbug47uQCLIB&heading=22&pitch=-5&fov=55