סקירה כללית על Directions API

Directions API הוא שירות שמקבל בקשת HTTP ומחזיר מסלול בין מיקומים בפורמט JSON או XML.

למה כדאי להשתמש ב-Directions API

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

מה אפשר לעשות עם Directions API?

באמצעות Directions API אפשר לחשב מסלולים בין מיקומים, כולל הפרטים הבאים:

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

איך פועל Directions API

כשמחשבים מסלולים, Directions API מחזיר את המסלולים הכי יעילים. המוצר מחשב את הגורמים הבאים במסגרת חישוב המסלול היעיל ביותר:

  • זמן הנסיעה (ראשי)
  • מרחק
  • מספר הפניות

הבקשה לדוגמה הבאה מחזירה מסלול נסיעה מטורונטו, אונטריו למונטריאול, קוויבק בפורמט JSON:

https://maps.googleapis.com/maps/api/directions/json
  ?destination=Montreal
  &origin=Toronto
  &key=YOUR_API_KEY

משאבים

בטבלה הבאה מפורט סיכום של המשאבים שזמינים דרך Directions API, יחד עם הנתונים שהוא מחזיר.

מקורות נתונים הנתונים שהוחזרו פורמט ההחזרה
מסלול

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

מסלול מפורט, שמחולק למסלולים, לקטעים ולשלבים. פרטים נוספים זמינים במאמר תשובות להנחיות.
  • JSON
  • XML

איך משתמשים ב-Directions API

1 הגדרה מתחילים בהגדרת הפרויקט ב-Google Cloud ומבצעים את ההוראות להגדרה שמופיעות בהמשך.
2 לניסיון הדגמה אחרי שתקבלו מפתח API ופרויקט ב-Cloud, תוכלו לנסות את הדמו של ההוראות ללא תשלום. הדגמה של Directions API
3 יצירת בקשה כדאי לעיין בבקשות לדוגמה ולקרוא על האפשרויות הזמינות שאפשר לספק, כמו צורות נסיעה, נקודות ציון והגבלות על מסלולים. דוגמאות למסלולים
4 הסבר על העקרונות הבסיסיים של תגובות כדאי לבדוק את תגובות הנתונים כדי להתכונן לשימוש בנתוני מסלולי הגעה באפליקציה. פרטים נוספים זמינים במאמר תגובות לנתונים.
5 שילבו נתוני מסלול באפליקציה שלכם! אפשר להשתמש בנתונים האלה כדי לחשב את המרחק והזמן של הנסיעה.

ספריות הלקוח הזמינות

אפשר לקרוא ל-API הזה בשפה הרצויה באמצעות אחת מספריות הלקוח הבאות:

ספריות הלקוח של Java, ‏ Python, ‏ Go ו-Node.js לשירותי מפות Google הן ספריות לקוח שנתמכות על ידי הקהילה, בקוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם מ-GitHub, שבו אפשר למצוא גם הוראות התקנה וקוד לדוגמה.

המאמרים הבאים