סקירה כללית על Directions API (קודם)

מפתחים באזור הכלכלי האירופי (EEA)

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

למה להשתמש ב-Directions API (הדור הקודם)

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

מה אפשר לעשות עם Directions API (הדור הקודם)?

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

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

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

מציינים את נקודות המוצא והיעדים באמצעות מזהי מקומות, כתובות או קואורדינטות של קווי רוחב ואורך. פרטים נוספים זמינים בקטע פרמטרים נדרשים.

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

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