- בקשת HTTP
- גוף הבקשה
- גוף התשובה
- PolylineQuality
- PolylineEncoding
- ReferenceRoute
- ExtraComputation
- מסלול
- RouteLabel
- RouteLeg
- קו פוליגוני
- RouteLegStep
- NavigationInstruction
- מנובר
- RouteLegStepTravelAdvisory
- RouteLegStepLocalizedValues
- RouteLegStepTransitDetails
- TransitStopDetails
- TransitStop
- TransitDetailsLocalizedValues
- LocalizedTime
- TransitLine
- TransitAgency
- TransitVehicle
- TransitVehicleType
- RouteLegTravelAdvisory
- RouteLegLocalizedValues
- StepsOverview
- MultiModalSegment
- אזור תצוגה
- RouteLocalizedValues
- GeocodingResults
- GeocodedWaypoint:
מחזירה את המסלול הראשי יחד עם מסלולים חלופיים אופציונליים, בהינתן קבוצה של ציוני דרך סופיים ונקודות ביניים.
הערה: השיטה הזו מחייבת לציין אנונימיזציה של שדה תגובה בקלט. אפשר לספק את האנונימיזציה של שדות התגובה באמצעות הפרמטר $fields
או fields
של כתובת ה-URL, או באמצעות כותרת HTTP/gRPC X-Goog-FieldMask
(מידע נוסף זמין בקטע הכותרות והפרמטרים הזמינים של כתובות אתרים). הערך הוא רשימה של נתיבי שדות שמופרדים בפסיקים. אפשר לקרוא הסבר מפורט על התהליך של בניית נתיבי השדות.
לדוגמה, בשיטה הזו:
- אנונימיזציה של שדות בכל השדות הזמינים (לבדיקה ידנית):
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, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
arrivalTime |
זה שינוי אופציונלי. שעת ההגעה. הערה: ניתן לקבוע רק אם המאפיין חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
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
קבוצת ערכים שמציינים את איכות הקו הפוליגוני.
טיפוסים בני מנייה (enums) | |
---|---|
POLYLINE_QUALITY_UNSPECIFIED |
לא צוינה העדפה לאיכות של קו פוליגוני. ברירת המחדל היא OVERVIEW . |
HIGH_QUALITY |
מציין קו פוליגוני באיכות גבוהה, שנוצר באמצעות יותר נקודות מ-OVERVIEW , במחיר של גודל תגובה גדול יותר. אפשר להשתמש בערך הזה כאשר דרושה לך רמת דיוק גבוהה יותר. |
OVERVIEW |
מציין קו פוליגוני של סקירה כללית, שמורכב ממספר קטן של נקודות. יש להשתמש בערך הזה כשמציגים סקירה כללית של המסלול. לשימוש באפשרות הזו יש זמן אחזור נמוך יותר לבקשות בהשוואה לשימוש באפשרות HIGH_QUALITY . |
PolylineEncoding
מציין את הסוג המועדף של קו פוליגוני שיש להחזיר.
טיפוסים בני מנייה (enums) | |
---|---|
POLYLINE_ENCODING_UNSPECIFIED |
לא צוינה העדפה לסוג של קו פוליגוני. ברירת המחדל היא ENCODED_POLYLINE . |
ENCODED_POLYLINE |
ההגדרה קובעת איזה קו פוליגוני מקודד באמצעות אלגוריתם הקידוד של קו פוליגוני. |
GEO_JSON_LINESTRING |
מציין קו פוליגוני באמצעות פורמט GeoJSON LineString |
ReferenceRoute
נתיב הפניה נתמך ב-ComputeRoutesRequest.
טיפוסים בני מנייה (enums) | |
---|---|
REFERENCE_ROUTE_UNSPECIFIED |
לא בשימוש. בקשות שמכילות את הערך הזה נכשלות. |
FUEL_EFFICIENT |
מסלול חסכוני בדלק. מסלולים שמסומנים בערך הזה מותאמים לפרמטרים כמו צריכת דלק. |
ExtraComputation
חישובים נוספים שצריך לבצע במהלך השלמת הבקשה.
טיפוסים בני מנייה (enums) | |
---|---|
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 שניתן להעביר אל ה-SDK של הניווט. האסימון מאפשר ל-API של הניווט לשחזר את המסלול במהלך הניווט, ובמקרה של שינוי מסלול, לכבד את הכוונה המקורית כשיצרת את המסלול באמצעות קריאה ל-v2.computeRoutes. הלקוחות צריכים להתייחס לאסימון הזה בתור blob אטום. הוא לא מיועד לקריאה או לשינוי. הערה: |
RouteLabel
תוויות של
שעוזרות לזהות מאפיינים ספציפיים של המסלול להשוואה מול אחרים.Route
טיפוסים בני מנייה (enums) | |
---|---|
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 . כולל את סוג הקו הפוליגוני. ברירת המחדל היא coding_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 |
מצב הנסיעה שבו נעשה שימוש בשלב הזה. |
תמרון
קבוצת ערכים שמציינים את פעולת הניווט שיש לבצע בשלב הנוכחי (לדוגמה, פנייה שמאלה, מיזוג או ישר).
טיפוסים בני מנייה (enums) | |
---|---|
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 הוא 600, הייתם מצפים להמתנה של עשר דקות אם אתם מפספסים את האוטובוס. משך זמן בשניות עם עד תשע ספרות עשרוניות, המסתיים ב-' |
transitLine |
מידע על קו התחבורה הציבורית שבו נעשה שימוש בשלב הזה. |
stopCount |
מספר העצירות החל מהמוצא ועד לתחנת ההגעה. המספר הזה כולל את התחנה בזמן ההגעה, אבל לא כולל את תחנת היציאה. לדוגמה, אם המסלול שלך יוצא מתחנה א', עובר דרך תחנות ב' ו-ג' ומגיע בתחנה D, המספר של עצירות ביניים יחזור 3. |
tripShortText |
הטקסט שמופיע בלוחות הזמנים ובלוחות השילוט כדי לציין נסיעת תחבורה ציבורית לנוסעים. הטקסט צריך לזהות באופן ייחודי נסיעה שנכללת ביום שירות מסוים. לדוגמה, '538' הוא קו |
TransitStopDetails
פרטים לגבי עצירות בתחבורה הציבורית של RouteLegStep
.
ייצוג JSON |
---|
{ "arrivalStop": { object ( |
שדות | |
---|---|
arrivalStop |
מידע על תחנת ההגעה של השלב. |
arrivalTime |
זמן ההגעה המשוער לשלב. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
departureStop |
מידע על תחנת היציאה של השלב. |
departureTime |
זמן היציאה המשוער של השלב. חותמת זמן בפורמט "זולו" RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
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
סוג כלי הרכב עבור מסלולי תחבורה ציבורית.
טיפוסים בני מנייה (enums) | |
---|---|
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 |
האינדקס של נקודת הביניים התואמת בבקשה. השדה הזה יאוכלס רק אם ציון הדרך המתאים הוא ציון דרך בשלבי ביניים. |