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

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

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

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

מה ניתן לעשות עם Directions API?

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

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

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