- בקשת HTTP
- גוף הבקשה
- גוף התשובה
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- מסלול
- RouteLabel
- RouteLeg
- Polyline
- RouteLegStep
- NavigationInstruction
- מנובר
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- אזור תצוגה
- RouteLocalizedValues
- GeocodingResults
- GeocodedWaypoint
מחזירה את המסלול הראשי יחד עם מסלולים חלופיים אופציונליים, בהינתן קבוצה של ציוני דרך בטרמינל ובנקודת ביניים.
הערה: השיטה הזו מחייבת לציין אנונימיזציה של שדות תגובה בקלט. אפשר לספק את המסכה של שדות התגובה באמצעות פרמטר של כתובת אתר $fields
או fields
, או באמצעות כותרת HTTP/gRPC X-Goog-FieldMask
(מידע נוסף זמין בפרמטרים הזמינים של כתובות URL ובכותרות). הערך הוא רשימה של נתיבי שדות שמופרדים בפסיקים. במסמכי התיעוד המפורטים מוסבר איך ליצור את נתיבי השדות.
לדוגמה, בשיטה הזו:
- אנונימיזציה של כל השדות הזמינים (לבדיקה ידנית):
X-Goog-FieldMask: *
- מסכת שדות של משך הזמן, המרחק וקו הפוליגוני ברמת המסלול (הגדרת דוגמה לסביבת הייצור):
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline
Google לא ממליצה להשתמש במסכה של שדות התשובה עם התו הכללי לחיפוש (*
), או לציין את מסיכת השדות ברמה העליונה (routes
), מהסיבות הבאות:
- אם תבחרו רק את השדות שנחוצים לכם, השרת שלנו יוכל לשמור מחזורי חישוב כדי לאפשר לנו להחזיר לכם את התוצאה בזמן אחזור קצר יותר.
- בחירה רק בשדות שדרושים במשימת הייצור מבטיחה ביצועים יציבים של זמן אחזור. יכול להיות שנוסיף עוד שדות תגובה בעתיד, והשדות החדשים האלה עשויים לדרוש זמן חישוב נוסף. אם תבחרו את כל השדות או אם תבחרו את כל השדות ברמה העליונה, יכול להיות שתבחינו בירידה בביצועים כי כל שדה חדש שנוסיף ייכלל בתשובה באופן אוטומטי.
- אם תבחרו רק את השדות שנחוצים לכם, יתקבל גודל תגובה קטן יותר וכתוצאה מכך תפוקה רשת גבוהה יותר.
בקשת HTTP
POST https://routes.googleapis.com/directions/v2:computeRoutes
בכתובת ה-URL נעשה שימוש בתחביר המרת קידוד של gRPC.
גוף הבקשה
גוף הבקשה מכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "origin": { object ( |
שדות | |
---|---|
origin |
חובה. ציון דרך במקור. |
destination |
חובה. ציון דרך ליעד. |
intermediates[] |
זה שינוי אופציונלי. קבוצה של נקודות דרך לאורך המסלול (לא כולל נקודות סופיות), לעצירה או למעבר. יש תמיכה ב-25 ציוני דרך ברמת הביניים. |
travelMode |
זה שינוי אופציונלי. מציין את אמצעי התחבורה. |
routingPreference |
זה שינוי אופציונלי. מציינת איך לחשב את המסלול. השרת מנסה להשתמש בהעדפת הניתוב שנבחרה כדי לחשב את הנתיב. אם העדפת הניתוב גורמת לשגיאה או לזמן אחזור ארוך במיוחד, מוחזרת שגיאה. אפשר להגדיר את האפשרות הזו רק כאשר |
polylineQuality |
זה שינוי אופציונלי. מציין את ההעדפה שלך לאיכות של הקו הפוליגוני. |
polylineEncoding |
זה שינוי אופציונלי. מציינת את הקידוד המועדף לקו הפוליגוני. |
departureTime |
זה שינוי אופציונלי. שעת היציאה. אם לא מגדירים את הערך הזה, ברירת המחדל של הערך הזה היא השעה שבה שלחתם את הבקשה. הערה: אפשר לציין חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
arrivalTime |
זה שינוי אופציונלי. שעת ההגעה. הערה: ניתן להגדיר את הערך רק אם בשדה חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
computeAlternativeRoutes |
זה שינוי אופציונלי. מציינת אם לחשב מסלולים חלופיים בנוסף למסלול. לא מוחזרים מסלולים חלופיים לבקשות עם ציוני דרך מתווכים. |
routeModifiers |
זה שינוי אופציונלי. קבוצה של תנאים שמשפיעים על אופן החישוב של נתיבים. |
languageCode |
זה שינוי אופציונלי. קוד השפה BCP-47, כמו 'en-US' או 'sr-Latn'. מידע נוסף זמין במאמר מזהה הלוקאל של Unicode. במאמר שפות תמיכה אפשר למצוא את רשימת השפות הנתמכות. אם לא מציינים את הערך הזה, המערכת מסיקה את שפת התצוגה מהמיקום של בקשת המסלול. |
regionCode |
זה שינוי אופציונלי. קוד האזור, שצוין כ-ccTLD ("דומיין ברמה העליונה") כערך בן שני תווים. מידע נוסף זמין במאמר דומיינים ברמה העליונה עם קוד מדינה. |
units |
זה שינוי אופציונלי. מציינת את יחידות המידה של שדות התצוגה. השדות האלה כוללים את השדה |
optimizeWaypointOrder |
זה שינוי אופציונלי. אם המדיניות מוגדרת כ-True, השירות ינסה לצמצם את העלות הכוללת של המסלול על ידי שינוי הסדר של נקודות הביניים שצוינו. הבקשה תיכשל אם אחד מציוני הביניים הוא |
requestedReferenceRoutes[] |
זה שינוי אופציונלי. מציינת אילו מסלולי הפניה יש לחשב כחלק מהבקשה, בנוסף למסלול ברירת המחדל. מסלול הפניה הוא מסלול עם יעד לחישוב מסלול ששונה מיעד ברירת המחדל. לדוגמה, חישוב מסלול הייחוס של |
extraComputations[] |
זה שינוי אופציונלי. רשימה של חישובים נוספים שיכולים לשמש להשלמת הבקשה. הערה: החישובים הנוספים האלה עשויים להחזיר שדות נוספים בתשובה. צריך לציין את השדות הנוספים האלה גם במסכת השדות שתוחזר בתשובה. |
trafficModel |
זה שינוי אופציונלי. מציין את ההנחות לשימוש בחישוב זמן בתנועה. ההגדרה הזו משפיעה על הערך המוחזר בשדה משך הזמן ב- |
transitPreferences |
זה שינוי אופציונלי. מציינת את ההעדפות שמשפיעות על המסלול שמוחזר ב- |
גוף התשובה
v2.computeRoutes את הודעת התשובה.
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל נתונים במבנה הבא:
ייצוג JSON |
---|
{ "routes": [ { object ( |
שדות | |
---|---|
routes[] |
מכילה מערך של נתיבים מחושבים (עד שלושה) כשמציינים את |
fallbackInfo |
במקרים מסוימים שבהם השרת לא יכול לחשב את תוצאות המסלול עם כל העדפות הקלט, הוא עשוי להשתמש בשיטת חישוב אחרת. כשמשתמשים במצב חלופי, השדה הזה מכיל מידע מפורט על התשובה החלופית. אחרת, השדה הזה לא מוגדר. |
geocodingResults |
מכילה פרטי תגובה של קידוד גיאוגרפי עבור ציוני דרך שצוינו ככתובות. |
PolylineQuality
קבוצת ערכים המציינים את איכות הקו הפוליגוני.
טיפוסים בני מנייה (enum) | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
לא צוינה העדפת איכות לקו פוליגוני. ברירת המחדל היא OVERVIEW . |
HIGH_QUALITY |
מציין קו פוליגוני באיכות גבוהה – שמורכב ממספר נקודות גדול יותר מ-OVERVIEW , במחיר של תגובה גדולה יותר. כדאי להשתמש בערך הזה כשרוצים לשפר את הדיוק. |
OVERVIEW |
מציין קו פוליגוני של סקירה כללית - שמורכב ממספר קטן של נקודות. אפשר להשתמש בערך הזה להצגת סקירה כללית של המסלול. כשמשתמשים באפשרות הזו, זמן האחזור של הבקשה קצר יותר בהשוואה לשימוש באפשרות HIGH_QUALITY . |
PolylineEncoding
מציין את הסוג המועדף של קו פוליגוני שצריך להחזיר.
טיפוסים בני מנייה (enum) | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
לא צוינה העדפה לסוג קו פוליגוני. ברירת המחדל היא ENCODED_POLYLINE . |
ENCODED_POLYLINE |
מציינת קו פוליגוני שמקודד באמצעות אלגוריתם הקידוד של קו פוליגוני. |
GEO_JSON_LINESTRING |
מציין קו פוליגוני באמצעות פורמט GeoJSON LineString |
ReferenceRoute
מסלול עזר נתמך ב-ComputeRoutesRequest.
טיפוסים בני מנייה (enum) | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
לא בשימוש. בקשות שכוללות את הערך הזה נכשלות. |
FUEL_EFFICIENT |
מסלול חסכוני בדלק. מסלולים שמסומנים בתווית עם הערך הזה נקבעו כמסלולים שעברו אופטימיזציה לפרמטרים כמו צריכת דלק. |
ExtraComputation
חישובים נוספים לבצע במהלך השלמת הבקשה.
טיפוסים בני מנייה (enum) | |
---|---|
EXTRA_COMPUTATION_UNSPECIFIED |
לא בשימוש. לא יהיה ניתן להגיש בקשות שמכילות את הערך הזה. |
TOLLS |
מידע על כבישי האגרה עבור המסלולים. |
FUEL_CONSUMPTION |
צריכת הדלק המשוערת במסלולים. |
TRAFFIC_ON_POLYLINE |
קווים פוליגוניים מודעים לתנועה עבור הנתיבים. |
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS |
התג NavigationInstructions מוצג כמחרוזת טקסט מעוצבת של HTML. יש לקרוא את התוכן הזה כפי שהוא. התוכן הזה הוא לתצוגה בלבד. אין לנתח אותו באופן פרוגרמטי. |
נתיב
מסלול שמורכב מסדרה של מקטעי דרך מחוברים שמחברים בין נקודות התחלה, נקודות סיום וסיום.
ייצוג JSON |
---|
{ "routeLabels": [ enum ( |
שדות | |
---|---|
routeLabels[] |
תוויות של |
legs[] |
אוסף של רגליים (קטעי נתיב בין ציוני דרך) שמרכיבים את המסלול. כל רגל תואמת לנסיעה בין שתי |
distanceMeters |
מרחק הנסיעה של המסלול, במטרים. |
duration |
משך הזמן שנדרש כדי לנווט במסלול. אם מגדירים את משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
staticDuration |
משך הנסיעה במסלול בלי להביא בחשבון את מצב התנועה. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
polyline |
הקו הפוליגוני של הנתיב הכולל. הקו הפוליגוני הזה הוא הקו הפוליגוני המשולב של כל |
description |
תיאור של המסלול. |
warnings[] |
מערך אזהרות שיוצגו במהלך הצגת המסלול. |
viewport |
התיבה התוחמת של אזור התצוגה של הקו הפוליגוני. |
travelAdvisory |
מידע נוסף על המסלול. |
optimizedIntermediateWaypointIndex[] |
אם מגדירים את הערך של |
localizedValues |
ייצוגי טקסט של המאפיינים של |
routeToken |
אסימון מסלול בקידוד base64 שהוא בטוח לשימוש באינטרנט, שניתן להעביר ל-Navigation SDK, שמאפשר ל-Navigation SDK לשחזר את המסלול במהלך הניווט, ובמקרה של שינוי מסלול, מכבד את הכוונה המקורית כשיצרת את המסלול, על ידי קריאה אל v2.computeRoutes. הלקוחות צריכים להתייחס לאסימון הזה כאל blob אטום. אל תשוו את הערך שלו בבקשות שונות – האסימון עשוי להשתנות גם אם מוחזר אותו מסלול בדיוק. הערה: |
RouteLabel
תוויות של
שימושיות לזיהוי מאפיינים ספציפיים של המסלול לצורך השוואה לעומת אחרים.Route
טיפוסים בני מנייה (enum) | |
---|---|
ROUTE_LABEL_UNSPECIFIED |
ברירת מחדל – לא בשימוש. |
DEFAULT_ROUTE |
ברירת המחדל 'הכי טוב' המוחזר עבור חישוב המסלול. |
DEFAULT_ROUTE_ALTERNATE |
חלופה לברירת המחדל 'הכי טוב' מסלול. מסלולים כאלה יוחזרו כשמציינים . |
FUEL_EFFICIENT |
מסלול חסכוני בדלק. מסלולים שמסומנים בתווית הזו נקבעו כמסלולים שעברו אופטימיזציה לפרמטרים חסכוניים באנרגיה, כמו צריכת דלק. |
RouteLeg
מכיל קטע בין נקודות ציון שאינן via
.
ייצוג JSON |
---|
{ "distanceMeters": integer, "duration": string, "staticDuration": string, "polyline": { object ( |
שדות | |
---|---|
distanceMeters |
המרחק של המסלול במטרים. |
duration |
משך הזמן שנדרש כדי לנווט בקטע. אם המדיניות משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
staticDuration |
משך הנסיעה במסלול, מחושב בלי להביא בחשבון את מצב התנועה. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
polyline |
הקו הפוליגוני הכולל של הרגל הזו שכולל את הקו הפוליגוני של כל |
startLocation |
מיקום ההתחלה של הקטע הזה. המיקום הזה עשוי להיות שונה מהמיקום |
endLocation |
מיקום הסיום של הרגל הזו. המיקום הזה עשוי להיות שונה מהמיקום |
steps[] |
מערך של שלבים לסימון קטעים בתוך הקטע הזה. כל שלב מייצג הוראת ניווט אחת. |
travelAdvisory |
מכיל את המידע הנוסף שצריך ליידע את המשתמש, כמו מגבלות אפשריות של אזורי תנועה, במסלול. |
localizedValues |
ייצוגי טקסט של המאפיינים של |
stepsOverview |
סקירה כללית על השלבים במדריך |
מצולע פתוח
כוללת קו פוליגוני מקודד.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד polyline_type . כולל את סוג קו הפוליגוני. ברירת המחדל היא encoded_polyline. polyline_type יכול להיות רק אחת מהאפשרויות הבאות: |
|
encodedPolyline |
קידוד המחרוזת של הקו הפוליגוני באמצעות אלגוריתם הקידוד של קו פוליגוני |
geoJsonLinestring |
מציין קו פוליגוני באמצעות פורמט GeoJSON LineString. |
RouteLegStep
מכיל פלח של
. שלב תואם להוראת ניווט אחת. רגלי המסלול מורכבים ממדים.RouteLeg
ייצוג JSON |
---|
{ "distanceMeters": integer, "staticDuration": string, "polyline": { object ( |
שדות | |
---|---|
distanceMeters |
המרחק של השלב הזה במטרים. במקרים מסוימים יכול להיות שהשדה הזה לא מכיל ערך. |
staticDuration |
משך הנסיעה בשלב הזה בלי להביא בחשבון את מצב התנועה. במקרים מסוימים יכול להיות שהשדה הזה לא מכיל ערך. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
polyline |
הקו הפוליגוני המשויך לשלב הזה. |
startLocation |
מיקום ההתחלה של השלב הזה. |
endLocation |
מיקום הסיום של השלב הזה. |
navigationInstruction |
הוראות ניווט. |
travelAdvisory |
מכיל את המידע הנוסף שהמשתמש צריך לקבל לגביו דיווח, למשל מגבלות אפשריות של אזורי תנועה, בשלב הצעדים. |
localizedValues |
ייצוגי טקסט של המאפיינים של |
transitDetails |
פרטים שקשורים לשלב הזה אם מצב הנסיעה הוא |
travelMode |
מצב הנסיעה שנעשה בו שימוש בשלב הזה. |
תמרון
קבוצת ערכים שמציינים את פעולת הניווט שיש לבצע בשלב הנוכחי (לדוגמה: פנייה שמאלה, מיזוג או ישר).
טיפוסים בני מנייה (enum) | |
---|---|
MANEUVER_UNSPECIFIED |
לא בשימוש. |
TURN_SLIGHT_LEFT |
צריך לסובב קצת שמאלה. |
TURN_SHARP_LEFT |
פונים פנייה חדה שמאלה. |
UTURN_LEFT |
בצעו פניית פרסה שמאלה. |
TURN_LEFT |
צריך לפנות שמאלה. |
TURN_SLIGHT_RIGHT |
צריך לפנות מעט ימינה. |
TURN_SHARP_RIGHT |
פונים פנייה חדה ימינה. |
UTURN_RIGHT |
בצעו פניית פרסה ימינה. |
TURN_RIGHT |
צריך לפנות ימינה. |
STRAIGHT |
עליך להמשיך ישר. |
RAMP_LEFT |
השתמשו ברמפה השמאלית. |
RAMP_RIGHT |
השתמשו ברמפה הימנית. |
MERGE |
מיזוג לתנועה. |
FORK_LEFT |
לוקחים את המזלג השמאלי. |
FORK_RIGHT |
קחו את המזלג הימני. |
FERRY |
קח את המעבורת. |
FERRY_TRAIN |
לוקחים את הרכבת שמובילה למעבורת. |
ROUNDABOUT_LEFT |
בכיכר יש לפנות שמאלה. |
ROUNDABOUT_RIGHT |
יש לפנות ימינה בכיכר. |
DEPART |
תמרון ראשוני. |
NAME_CHANGE |
משמש לציון שינוי בשם הרחוב. |
RouteLegStepTravelAdvisory
מכיל את המידע הנוסף שצריך ליידע את המשתמש, כמו הגבלות אפשריות על אזורי התנועה בשלב הצעדים.
ייצוג JSON |
---|
{
"speedReadingIntervals": [
{
object ( |
שדות | |
---|---|
speedReadingIntervals[] |
הערה: השדה הזה לא מאוכלס כרגע. |
RouteLegStepLocalizedValues
ייצוגי טקסט של מאפיינים מסוימים.
ייצוג JSON |
---|
{ "distance": { object ( |
שדות | |
---|---|
distance |
מרחק הנסיעה מיוצג בפורמט טקסט. |
staticDuration |
משך הזמן, מבלי להביא בחשבון את מצב התנועה, מיוצג בפורמט טקסט. |
RouteLegStepTransitDetails
מידע נוסף לגבי RouteLegStep
שקשור למסלולים של TRANSIT
.
ייצוג JSON |
---|
{ "stopDetails": { object ( |
שדות | |
---|---|
stopDetails |
מידע על שעת ההגעה והיציאה של השלב הזה. |
localizedValues |
ייצוגי טקסט של המאפיינים של |
headsign |
מציינת את כיוון הנסיעה בקו הזה כפי שמסומן ברכב או בתחנת היציאה. לרוב, הכיוון הוא תחנת הטרמינל. |
headway |
מציין את משך הזמן הצפוי בין היציאות מאותה תחנה כרגע. לדוגמה, עם ערך שניות מקדים של 600, אפשר לצפות להמתנה של עשר דקות אם תפספסו את האוטובוס. משך זמן בשניות עם עד תשע ספרות עשרוניות, שמסתיים ב-' |
transitLine |
מידע על קו התחבורה הציבורית שבו נעשה שימוש בשלב הזה. |
stopCount |
מספר התחנות מנקודת היציאה עד לתחנת ההגעה. המספר הזה כולל את תחנת ההגעה, אבל לא כולל את תחנת היציאה. לדוגמה, אם המסלול יוצא מתחנה א', עובר דרך את עצירות ב' ו-ג' ומגיע לתחנה D, התחנה stopCount תחזיר את הערך 3. |
tripShortText |
הטקסט שמופיע בלוחות זמנים ובלוחות של חתימה כדי לזהות נסיעה בתחבורה ציבורית לנוסעים. הטקסט צריך לזהות את הנסיעה באופן ייחודי ביום השירות. לדוגמה, "538" הוא ה |
TransitStopDetails
פרטים על תחנות התחבורה הציבורית של RouteLegStep
.
ייצוג JSON |
---|
{ "arrivalStop": { object ( |
שדות | |
---|---|
arrivalStop |
מידע על תחנת ההגעה של השלב. |
arrivalTime |
זמן ההגעה המשוער של השלב. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
departureStop |
מידע על תחנת היציאה של השלב. |
departureTime |
זמן היציאה המשוער של השלב. חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
TransitStop
מידע על תחנת תחבורה ציבורית.
ייצוג JSON |
---|
{
"name": string,
"location": {
object ( |
שדות | |
---|---|
name |
שם התחנה של התחבורה הציבורית. |
location |
מיקום העצירה מבוטא בקואורדינטות של קו אורך/רוחב. |
TransitDetailsLocalizedValues
תיאורי ערכים מותאמים לשוק המקומי עבור RouteTransitDetails
.
ייצוג JSON |
---|
{ "arrivalTime": { object ( |
שדות | |
---|---|
arrivalTime |
שעה בייצוג הטקסט המעוצב עם אזור זמן תואם. |
departureTime |
שעה בייצוג הטקסט המעוצב עם אזור זמן תואם. |
LocalizedTime
תיאור זמן מותאם לשוק המקומי.
ייצוג JSON |
---|
{
"time": {
object ( |
שדות | |
---|---|
time |
השעה שצוינה כמחרוזת באזור זמן נתון. |
timeZone |
מכילה את אזור הזמן. הערך הוא השם של אזור הזמן כפי שמוגדר במסד הנתונים של אזור זמן IANA, למשל. 'America/New_York'. |
TransitLine
מכיל מידע על קו התחבורה הציבורית שבו נעשה שימוש בשלב הזה.
ייצוג JSON |
---|
{ "agencies": [ { object ( |
שדות | |
---|---|
agencies[] |
חברת התחבורה הציבורית שמפעילה את קו התחבורה הציבורית הזה. |
name |
השם המלא של קו התחבורה הציבורית הזה, לדוגמה, ' 8 Avenue Local' |
uri |
את ה-URI של קו התחבורה הציבורית הזה, כפי שסופק על ידי חברת התחבורה הציבורית. |
color |
הצבע הנפוץ בשילוט של הקו הזה. מיוצגת בהקסדצימלי. |
iconUri |
ה-URI של הסמל המשויך לשורה הזו. |
nameShort |
השם המקוצר של קו התחבורה הציבורית הזה. השם הזה יהיה בדרך כלל מספר שורה, כמו M7 או 355. |
textColor |
הצבע שבו משתמשים בדרך כלל בטקסט בשילוט של הקו הזה. מיוצגת בהקסדצימלי. |
vehicle |
סוג כלי הרכב שפועל בקו התחבורה הציבורית הזה. |
TransitAgency
חברת תחבורה ציבורית שמפעילה קו תחבורה ציבורית.
ייצוג JSON |
---|
{ "name": string, "phoneNumber": string, "uri": string } |
שדות | |
---|---|
name |
השם של חברת התחבורה הציבורית הזו. |
phoneNumber |
מספר טלפון בפורמט הספציפי לאזור של חברת התחבורה הציבורית. |
uri |
ה-URI של חברת התחבורה הציבורית. |
TransitVehicle
מידע על כלי רכב שמשמשים במסלולי תחבורה ציבורית.
ייצוג JSON |
---|
{ "name": { object ( |
שדות | |
---|---|
name |
שם הרכב הזה, באותיות רישיות. |
type |
סוג כלי הרכב. |
iconUri |
ה-URI של סמל שמשויך לסוג הרכב הזה. |
localIconUri |
ה-URI של הסמל המשויך לסוג הרכב הזה, על סמך השילוט המקומי לתחבורה. |
TransitVehicleType
סוג כלי הרכב שמיועדים לנתיבי תחבורה ציבורית.
טיפוסים בני מנייה (enum) | |
---|---|
TRANSIT_VEHICLE_TYPE_UNSPECIFIED |
לא בשימוש. |
BUS |
אוטובוס. |
CABLE_CAR |
כלי רכב שמשתמש בכבל, בדרך כלל על הקרקע. רכבל אווירי עשוי להיות מסוג GONDOLA_LIFT . |
COMMUTER_TRAIN |
רכבת עילית. |
FERRY |
מעבורת. |
FUNICULAR |
כלי רכב שמושך שיפוע תלול באמצעות כבל. פוניקולר מורכב בדרך כלל משתי מכוניות, וכל מכונית משמשת כמשקל נגד השנייה. |
GONDOLA_LIFT |
רכבל אווירי. |
HEAVY_RAIL |
רכבת כבדה. |
HIGH_SPEED_TRAIN |
רכבת מהירה. |
INTERCITY_BUS |
אוטובוס בינעירוני. |
LONG_DISTANCE_TRAIN |
רכבת למרחקים ארוכים. |
METRO_RAIL |
תחבורה ציבורית קלה. |
MONORAIL |
רכבת מונורייל. |
OTHER |
כל שאר כלי הרכב. |
RAIL |
רכבת. |
SHARE_TAXI |
מונית משותפת היא סוג של אוטובוס עם יכולת להוריד ולאסוף נוסעים בכל מקום במסלול. |
SUBWAY |
רכבת קלה תת-קרקעית. |
TRAM |
רכבת קלה מעל פני הקרקע. |
TROLLEYBUS |
טרוליבוס. |
RouteLegTravelAdvisory
מכיל את המידע הנוסף שהמשתמש צריך לקבל לגביו מידע על צעד אחד, כמו הגבלות אפשריות לפי אזור התנועה.
ייצוג JSON |
---|
{ "tollInfo": { object ( |
שדות | |
---|---|
tollInfo |
מכילה מידע על כבישי אגרה בכביש |
speedReadingIntervals[] |
מרווחי זמן לקריאה של מהירות המפרטים את צפיפות התנועה. רלוונטי להעדפות ניתוב דוגמה:
|
RouteLegLocalizedValues
ייצוגי טקסט של מאפיינים מסוימים.
ייצוג JSON |
---|
{ "distance": { object ( |
שדות | |
---|---|
distance |
מרחק הנסיעה מיוצג בפורמט טקסט. |
duration |
משך הזמן שהמערכת מביאה בחשבון את מצב התנועה, מיוצגת בפורמט טקסט. הערה: אם לא ביקשתם מידע על תנועה, הערך הזה יהיה זהה לערך staticDuration. |
staticDuration |
משך הזמן, מבלי להביא בחשבון את מצב התנועה, מיוצג בפורמט טקסט. |
StepsOverview
מספקת מידע כללי על רשימה של RouteLegStep
.
ייצוג JSON |
---|
{
"multiModalSegments": [
{
object ( |
שדות | |
---|---|
multiModalSegments[] |
סיכום של המידע על פלחים שונים במספר מצבים של |
MultiModalSegment
הצגת סיכום של המידע על פלחים שונים במספר מצבים של RouteLeg.steps
. מקטע מרובה מצבים מוגדר כ-RouteLegStep
רציף אחד או יותר שיש להם אותו RouteTravelMode
. השדה הזה לא יאוכלס אם ה-RouteLeg
לא מכיל פלחים מרובי-מודאליים בשלבים.
ייצוג JSON |
---|
{ "navigationInstruction": { object ( |
שדות | |
---|---|
navigationInstruction |
הוראות ניווט לפלח מרובה מצבים. |
travelMode |
מצב המעבר של הקטע מרובה המודלים. |
stepStartIndex |
האינדקס התואם של |
stepEndIndex |
האינדקס המתאים |
אזור התצוגה
אזור תצוגה של קו רוחב, מיוצג בשתי אלכסון מול low
ו-high
נקודות. אזור תצוגה נחשב לאזור סגור, כלומר הוא כולל את התחום שלו. גבולות הרוחב חייבים להיות בטווח של -90 עד 90 מעלות כולל, וגבולות קו האורך חייבים לנוע בין -180 ל-180 מעלות, כולל. מקרים שונים כוללים:
אם
low
=high
, אזור התצוגה מורכב מנקודה אחת בלבד.אם
low.longitude
>high.longitude
, טווח קו האורך הפוך (אזור התצוגה חוצה את קו האורך 180 מעלות).אם
low.longitude
= -180 מעלות ו-high.longitude
= 180 מעלות, אזור התצוגה כולל את כל קווי האורךאם
low.longitude
= 180 מעלות ו-high.longitude
= 180 מעלות, טווח קו האורך ריק.אם
low.latitude
>high.latitude
, טווח קו הרוחב ריק.
צריך לאכלס גם את low
וגם את high
, והתיבה המיוצגת לא יכולה להיות ריקה (כפי שצוין בהגדרות שלמעלה). אזור תצוגה ריק יגרום לשגיאה.
לדוגמה, אזור התצוגה הזה כולל את כל העיר תל אביב:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
ייצוג JSON |
---|
{ "low": { object ( |
שדות | |
---|---|
low |
חובה. הנקודה הנמוכה של אזור התצוגה. |
high |
חובה. הנקודה הגבוהה של אזור התצוגה. |
RouteLocalizedValues
ייצוגי טקסט של מאפיינים מסוימים.
ייצוג JSON |
---|
{ "distance": { object ( |
שדות | |
---|---|
distance |
מרחק הנסיעה מיוצג בפורמט טקסט. |
duration |
משך הזמן, תוך התייחסות למצב התנועה, מיוצג בפורמט טקסט. הערה: אם לא ביקשתם מידע על תנועה, הערך הזה יהיה זהה לערך של |
staticDuration |
משך הזמן, מבלי להביא בחשבון את מצב התנועה, מיוצג בפורמט טקסט. |
transitFare |
מחיר הכרטיס לתחבורה הציבורית מיוצג בפורמט טקסט. |
GeocodingResults
מכיל
לציון נקודת המוצא, היעד וציוני הדרך הביניים. השדה הזה מאוכלס רק עבור ציוני דרך של כתובות.GeocodedWaypoints
ייצוג JSON |
---|
{ "origin": { object ( |
שדות | |
---|---|
origin |
ציון דרך שעבר קידוד גיאוגרפי של המקור. |
destination |
ציון דרך שעבר קידוד גיאוגרפי של היעד. |
intermediates[] |
רשימה של נקודות ציון מתווכות שעברו קידוד גיאוגרפי, שכל אחת מהן מכילה שדה אינדקס שתואם למיקום מבוסס האפס של ציון הדרך לפי הסדר שבו צוינו בבקשה. |
GeocodedWaypoint
פרטים על המיקומים שמשמשים כציוני דרך. השדה הזה מאוכלס רק עבור ציוני דרך של כתובות. כולל פרטים על תוצאות הקידוד הגיאוגרפי כדי לקבוע מהי הכתובת שהועתקה לכתובת.
ייצוג JSON |
---|
{
"geocoderStatus": {
object ( |
שדות | |
---|---|
geocoderStatus |
ציון קוד הסטטוס שנוצר מפעולת הקידוד הגיאוגרפי. |
type[] |
סוגי התוצאה, בצורת אפס תגי סוג או יותר. סוגים נתמכים: סוגי כתובות וסוגי רכיבי כתובת. |
partialMatch |
מציין שהמקודד הגיאוגרפי לא החזיר התאמה מדויקת לבקשה המקורית, למרות שהוא הצליח להתאים חלק מהכתובת המבוקשת. מומלץ לבדוק את הבקשה המקורית עם שגיאות כתיב ו/או כתובת חלקית. |
placeId |
מזהה המקום של התוצאה הזו. |
intermediateWaypointRequestIndex |
האינדקס של ציון הדרך המתאים בבקשה. השדה הזה מאוכלס רק אם ציון הדרך המתאים הוא ציון ביניים. |