סקירה כללית על 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, שם אפשר גם למצוא הוראות התקנה וקוד לדוגמה.

מה עושים אחר כך