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

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

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

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

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

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

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

איך פועל 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 ופרויקט בענן, תוכלו לנסות את הדגמה של ההוראות ללא תשלום. הדגמה של Directions API
3 יצירת בקשה כדאי לעיין בבקשות לדוגמה ולקרוא על האפשרויות הזמינות שאפשר לספק, כמו צורות נסיעה, נקודות ציון והגבלות על מסלולים. דוגמאות למסלולים
4 הסבר על העקרונות הבסיסיים של תגובות כדאי לבדוק את התשובות של הנתונים כדי להתכונן לשימוש בנתוני מסלולי הגעה באפליקציה. פרטים נוספים זמינים במאמר תשובות של נתונים.
5 שילבו נתוני מסלול באפליקציה שלכם! אפשר להשתמש בנתונים האלה כדי לחשב את המרחק והזמן של הנסיעה.

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

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

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

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