מדריך מהיר לכתובות URL של מפות Google

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

כתובות URL של מפות Google: עובדות חשובות

כתובות URL של מפות Google: מתי להשתמש בהן

מתי כדאי להשתמש בכתובות URL של מפות Google:

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

מתי לא כדאי להשתמש בכתובות URL ממפות Google:

  • אתם כבר מבקשים Place Details ורוצים קישורים למפות Google בפורמט מוגדר מראש בשביל מקום מסוים (השדות googleMapsUri או googleMapsLinks). במקום זאת, צריך להשתמש ב-Places API (חדש).
  • אתם צריכים תכונות שזמינות רק בנייד כשאתם מפעילים את אפליקציית מפות Google. השתמשו ב-Google Maps Intents ל-Android או בסכמת ה-URL של מפות Google ל-iOS.

כתובות URL של מפות Google: הגדרה

  • שיוך השימוש: מוסיפים לכתובות ה-URL של מפות Google את הפרמטרים האופציונליים של השאילתה utm_source (שם האפליקציה) ו-utm_campaign (הפעולה שהמשתמש רוצה לבצע, למשל place_details_search).
  • תחילת העבודה: הגדרת כתובות URL של מפות Google

כתובות URL של מפות Google: טעויות נפוצות

  • הבעיה: כתובת URL לחיפוש שכוללת רק קווי רוחב ואורך ב-query מציגה סיכה, אבל לא מציגה פרטי מקום במפה או בחלונית הצדדית. הפתרון: משתמשים ב-query=PLACE_NAME,ADDRESS או מוסיפים את query_place_id לצד query כדי להציג את הפרטים של המקום הספציפי. אפשר לקרוא מידע נוסף בכתובת /maps/documentation/urls/get-started.
  • הבעיה: הפרמטרים של מזהה המקום (query_place_id,‏ origin_place_id,‏ destination_place_id,‏ waypoint_place_ids) לא פועלים לבד. הפתרון: כשמעבירים פרמטר של מזהה מקום, צריך תמיד לכלול את הפרמטר הבסיסי התואם (query,‏ origin,‏ destination או waypoints). אפשר לקרוא מידע נוסף בכתובת /maps/documentation/urls/get-started.
  • הבעיה: הפרמטר waypoints לא נכלל במוצרים של מפות Google שלא תומכים בנקודות ציון, ויש לו מגבלות ספירה שתלויות בפלטפורמה. הפרמטר dir_action=navigate לא נכלל במקומות שבהם הניווט לא זמין. הפתרון: אל תשתמשו ביותר משלוש נקודות ציון בקישורים שנפתחים בדפדפנים בנייד (אחרת, השתמשו בתשע נקודות ציון), ואל תסתמכו על כך ש-waypoints או dir_action=navigate יפעלו בכל מוצר או מסלול של מפות Google. אפשר לעיין בכתובת /maps/documentation/urls/get-started#directions-action.
  • הבעיה: מפות Google ו-Street View משתפים את אותה נקודת קצה (@), ולכן כתובת URL של מפה בלי הפעולה הנכונה לא תציג מפה. תיקון: מגדירים את map_action=map לתצוגות מפה ואת map_action=pano לתמונות פנורמיות ב-Street View. מידע נוסף זמין בכתובת /maps/documentation/urls/get-started.
  • הבעיה: אם api=1 חסר בכתובת URL של מפות Google, המערכת מתעלמת מכל הפרמטרים ומפות Google נפתחות בתצוגת ברירת המחדל. התיקון: צריך לכלול את api=1 בכל כתובת URL של מפות Google (1 הוא הערך התקין היחיד). /maps/documentation/urls/get-started#forming-the-url