יש גרסה חדשה יותר של המסמך הזה עם דוגמאות לשימוש ב-Places API וב-Routes API החדשים.
בדרך כלל, כשמשתמש נוהג לנקודת עניין (POI), הוא צריך ניווט למיקום סמוך כמו חניון או נקודת גישה. תארו לעצמכם נהג שצריך להגיע לשדה תעופה או לקניון. כשנוסעים לנמל תעופה, הנהג מנסה להגיע לטרמינל או לנקודת הורדה ולא למרכז המתחם של נמל התעופה. באופן דומה, חניון ליד מרכז קניות יכול להיות אפשרות טובה בהרבה למשתמש עם רכב. במקרה כזה, כשמפתחים אפליקציה או שירות לניווט הנהג, צריך קודם למצוא את המיקום שאליו הוא נוסע ואז להציע לו יעדים אופציונליים בקרבת המיקום הזה. הגישה הזו מאפשרת לכם לספק שירות טוב יותר ללקוחות ולהראות שאתם מעריכים את הזמן שלהם. כל זאת באמצעות מאמץ פיתוח קטן אך חכם שממנף נתוני מיקום שסופקו על ידי הפלטפורמה של מפות Google.
Simplified view of systems involved when guiding the driver to a location with a car

נראה לכם איך אפשר להשתמש ב-Places API וב-Directions API ברצף או בשילוב כדי לזהות את המיקום המתאים לחנייה ליד היעד. הפתרון הזה נועד להסיר את אי הוודאות ולצמצם את מספר האינטראקציות כדי למצוא מקום חנייה כשמתקרבים ליעד הסופי. בואו נבחן שתי דוגמאות להטמעה מפורטת של המקרים האלה.
דוגמה 1 – אטרקציה תיירותית ללא מגרש חניה
נבחר מיקום שלא מחובר ישירות לשולי הכביש, כך שצריך לאחזר מסלול בנפרד. יעד הוא נוטרדאם בפריז, ונקודת ההתחלה היא תחנת הרכבת Gare de l’Est (48.87697775149635, 2.3592247806755564).

הנהג יוצא מהתחנה כ-16 דקות צפונית לנוטרדאם. נוטרדאם היא אטרקציה תיירותית מפורסמת באי עם גישה באמצעות גשר, כמה רחובות חד-סטריים ואין חניון גדול בקרבת מקום, כך שזו צריכה להיות משימה מעניינת.
בקשה ל-Places API
בדוגמה הזו של בקשה ל-Places API נעשה שימוש בחיפוש טקסט כדי למצוא את נוטרדאם. פרטים נוספים זמינים במסמכי התיעוד למפתחים. המחרוזת YOUR_KEY בדוגמאות האלה היא מפתח ה-API שקיבלתם עבור ממשקי ה-API של המקומות וההוראות של הפלטפורמה של מפות Google, שהופעלו ב-Google Cloud Console. הסבר מפורט יותר זמין במאמר תחילת העבודה עם הפלטפורמה של מפות Google.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=notre_dame&location=48.864716%2C2.349014®ion=fr&key=YOUR_KEY
בתגובה לבקשה שלמעלה, מתקבלות הקואורדינטות הבאות של קו הרוחב וקו האורך:
"results" : [ { "formatted_address" : "Notre Dame, Paris", "geometry" : { "location" : { "lat" : 48.8527288, }, ...
כמו שאפשר לראות, הקואורדינטות אכן מצביעות על נוטרדאם.
![]() |
![]() |
אם אתם מפתחים או ספקי שירותים, כדאי להציג לנהג באופן אוטומטי את ההודעה 'מחפש חנייה ליד נוטרדאם?'. חוויית המשתמש תהיה שונה בהתאם למכשיר ולמסך, אבל במקרה הזה כדאי לשקול להציג חלון קופץ עם טקסט שייעלם אחרי זמן קצר. כדי למצוא חנייה ליד נוטרדאם, מבצעים חיפוש טקסט ב-Places API עם הפרמטרים type=parking ו-radius=300. בדוגמה הזו, התוצאות יהיו מוטות לטובת אזורי חנייה במרחק של עד 300 מטר מנוטרדאם.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=parking
&location=48.8527288%2C2.3505635®ion=fr&type=parking&radius=300&key=YOUR_KEY
התוצאה הראשונה היא 'חניון Saemes Maubert-Lagrange' במיקום 48.850591, 2.3486436. נשתמש במיקום הזה בחלק הבא, שבו נשלח בקשה ל-Directions API.
בקשה ל-Directions API
כדי למצוא את המסלול מהתחנה לחניון שקרוב לקתדרלת נוטרדאם, צריך לשלוח בקשה ל-Directions API. פשוט מגדירים את פרמטרי המוצא והיעד. אפשר למצוא אפשרויות נוספות במסמכי התיעוד למפתחים.
https://maps.googleapis.com/maps/api/directions/json?origin=48.8767903,2.3592251&destination=48.850591%2C2.3486436&key=YOUR_KEY
התשובה של Direction API בדרך כלל מכילה כמה הצעות למסלולים. כל מסלול מורכב מכמה 'קטעים', והקטעים האלה מכילים כמה 'שלבים' שבהם מוצגים מרחק הנסיעה והקואורדינטות. כדי למצוא את הקואורדינטות הסופיות שאפשר להגיע אליהן ברכב, צריך להשתמש בשדה end_location של השלב האחרון בקטע האחרון במסלול שבחרתם.
יכול להיות שהמיקום הזה לא נראה כמו הבחירה הראשונה, אבל אם תסתכלו במפה או בתצוגת רחוב של Google, תראו שהמיקום הזה נמצא במרחק הליכה קצר מאוד, בערך 6-7 דקות, מנוטרדאם.

מסלול הליכה מאזור החנייה אל נוטרדאם
סיכום לדוגמה 1
כפי שאפשר לראות, כדי למצוא אזור חניה לרכב צריך רק כמה קריאות ל-API ולהציג את ההצעה לנהג. כך המשתמשים שלכם חוסכים זמן כי הם לא צריכים לנסוע ברחובות חד-סטריים או לנסות למצוא מקום להחנות את הרכב באטרקציה תיירותית עמוסה. לסיכום, ביצענו את בקשות ה-API הבאות:
- בקשה ל-Places API כדי למצוא את הקואורדינטות של נוטרדאם
- בקשה ל-Places API כדי למצוא אזור חניה בטווח של 300 מטר מהקואורדינטות האלה
- בקשה ל-Directions API כדי למצוא מסלול לאזור החניה
דוגמה 2 – הנחיה לטרמינל בשדה תעופה גדול

"types" : [ "airport", "point_of_interest", "establishment" ],
עם זאת, כל מי שביקר בשדה תעופה גדול יודע שנדרש זמן רב כדי לעבור בין הטרמינלים אם מגיעים למיקום הלא נכון. במקרה הזה, סוג תוצאת החיפוש הוא 'שדה תעופה', ולכן כדאי להמשיך את השאילתה באופן אוטומטי ולחפש 'טרמינל' במיקום של נמל התעופה הית'רו בלונדון (51.47016927594547, -0.45432767852489075). בדוגמה אפשר לראות גם את ההגבלה האופציונלית של רדיוס החיפוש ל-3,000 מטרים.
https://maps.googleapis.com/maps/api/place/textsearch/json?query=terminal&location=51.47016927594547%2C-0.45432767852489075®ion=gb&key=YOUR_KEY&radius=3000
השאילתה שלמעלה מחזירה רשימה של מסופי התשלום ונקודות המסירה הספציפיות במסופים האלה. ברשימת התוצאות אפשר למצוא את 'London Heathrow Airport Terminal 5' ואת מזהה המקום שלו:
"place_id" : "ChIJtQRd6XVxdkgRTUGZtcsoGNc",
באמצעות הפרמטר place_id, אפשר לציין ל-Directions API שאנחנו מנסים להגיע למקום מסוים ולא לקואורדינטות שרירותיות.
https://maps.googleapis.com/maps/api/directions/json?origin=51.557263604707224,-0.2794575145680608&destination=place_id:ChIJtQRd6XVxdkgRTUGZtcsoGNc&key=YOUR_KEY
כמו בדוגמה הקודמת, אם קוראים את כל השלבים בתשובת ה-JSON, אפשר למצוא את החלק האחרון של המסלול ואת קו הרוחב וקו האורך של מיקומי הסיום (51.47079979999999,-0.4896765).

סיכום לדוגמה 2
כמו בדוגמה הקודמת, מאמצי הפיתוח שנדרשים כדי לספק לנהג הנחיות משופרות הם קטנים מאוד, והיתרונות של חיסכון בזמן לנהג ניתנים למדידה בקלות. ביצענו את הפעולות הבאות:
- בקשה ל-Places API כדי למצוא את נמל התעופה הית'רו
- בקשה ל-Places API כדי למצוא את כל הטרמינלים שקרובים לקואורדינטות של נמל התעופה הית'רו
- בקשה ל-Directions API לקבלת מסלול לטרמינל 5
סיכום
כפי שאפשר לראות, מאמץ הפיתוח שנדרש כדי לספק שירות פרימיום ללקוחות שנוסעים ברכב הוא קטן יחסית, ומאפשר לכם להראות בקלות שאתם חושבים על הצרכים של הלקוחות.
למטרות פיתוח, אתם יכולים להשתמש ברבות מהספריות והכלים שזמינים כדי לעזור לכם לבנות את השירותים ללקוחות שלכם. מומלץ לעיין במאגר GitHub של הפלטפורמה של מפות Google שזמין לציבור.
הפעולות הבאות
המחבר הראשי
מיקו טויבאנן | מהנדס פתרונות בפלטפורמה של מפות Google