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

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

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

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

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