למה כדאי להשתמש ב-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, עם הנתונים שמוצגים בו.
משאבי נתונים | הנתונים הוחזרו | פורמט החזרה |
---|---|---|
מסלול
מקורות ויעדים צריכים להיות בפורמט של מזהי מקומות, כתובות או קואורדינטות של קווי אורך ורוחב. אפשר לקרוא פרטים נוספים בקטע הפרמטרים הנדרשים. |
מסלול מפורט עם פירוט של מסלולים, רגליים וצעדים. לפרטים נוספים, אפשר לעיין בתגובות למסלול. |
|
איך משתמשים ב-Directions API
1 | להגדרה. | מתחילים עם הגדרת הפרויקט ב-Google Cloud ופועלים לפי הוראות ההגדרה. |
2 | להתנסות בהדגמה | ברגע שיהיה לכם מפתח API ופרויקט בענן, תוכלו לנסות את ההדגמה של המסלול ללא תשלום. אפשר לעיין בהדגמה של Directions API. |
3 | יצירת בקשה | אפשר לעיין בבקשות לדוגמה וללמוד על האפשרויות הזמינות שאפשר לספק, כמו אמצעי הגעה, ציוני דרך והגבלות מסלולים. דוגמאות למסלול. |
4 | הסבר בסיסי על תשובות | מעיינים בתגובות לנתונים כדי להתכונן לשימוש בנתוני המסלול לאפליקציה. לפרטים נוספים, אפשר לעיין בתגובות למסלולים. |
5 | שילוב נתוני מסלול באפליקציה שלכם! | אפשר להשתמש בנתונים האלה כדי לחשב את המרחק ואת הזמן של הנסיעה. |
ספריות לקוח זמינות
קוראים ל-API הזה בשפה שתבחרו, באמצעות אחת מספריות הלקוח הבאות:
- לקוח Java לשירותי מפות Google
- לקוח Python לשירותי מפות Google
- לקוח Go לשירותי מפות Google
- לקוח Node.js לשירותי מפות Google
לקוח Java, לקוח Python, לקוח Go ולקוח Node.js לשירותי מפות Google הן ספריות לקוח עם תמיכה מהקהילה, ומבוססות על קוד פתוח במסגרת רישיון Apache 2.0. אפשר להוריד אותם מ-GitHub, שם גם אפשר למצוא הוראות התקנה וקוד לדוגמה.
המאמרים הבאים
- כדי להתחיל להשתמש ב-Directions API: עוברים אל Get started (תחילת העבודה).
- כדי להתחיל לשלוח בקשות לקבלת מסלול: עוברים למאמר קבלת מסלול.
- יישום שיטות מומלצות: היכנסו למאמר בנושא שיטות מומלצות לשירותי אינטרנט.