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

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

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

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

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

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

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

איך פועל Directions API

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

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

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

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