Route Matrix

המחלקה RouteMatrix

מחלקה google.maps.routes.RouteMatrix

מטריצה של מסלולים שחושבו לקבוצה של צמדי מוצא/יעד על ידי RouteMatrix.computeRouteMatrix

כדי לקבל גישה, צריך לקרוא ל: const {RouteMatrix} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

שיטות סטטיות

computeRouteMatrix

computeRouteMatrix(request) פרמטרים:  request:  ComputeRouteMatrixRequest ערך מוחזר:  Promise<{matrix:RouteMatrix}> מקבלת רשימה של נקודות מוצא ויעדים ומחזירה מטריצה שמכילה מידע על המסלול לכל שילוב של נקודת מוצא ויעד. הערה: בשיטה הזו צריך לציין מסכת שדה תגובה בבקשה על ידי הגדרת המאפיין ComputeRouteMatrixRequest.fields. הערך הוא רשימה של נתיבי שדות. לדוגמה: אנונימיזציה של כל השדות הזמינים: fields: ['*'] אנונימיזציה של שדות למשך הזמן והמרחק ברמת המסלול: fields: ['durationMillis', 'distanceMeters'] לא מומלץ להשתמש באנונימיזציה של שדות בתגובה עם תו כללי לחיפוש fields: ['*'] כי: אם תבחרו רק את השדות שאתם צריכים, השרת שלנו יחסוך מחזורי חישוב, וכך נוכל להחזיר לכם את התוצאה עם זמן אחזור קצר יותר. כדי להבטיח ביצועי זמן אחזור יציבים, בחרו רק את השדות שאתם צריכים במשימת הייצור. יכול להיות שנוסיף עוד שדות תגובה בעתיד, והשדות החדשים האלה עשויים לדרוש זמן חישוב נוסף. אם תבחרו את כל השדות, או את כל השדות ברמה העליונה, יכול להיות שתהיה ירידה בביצועים כי כל שדה חדש שנוסיף ייכלל באופן אוטומטי בתגובה. אם תבחרו רק את השדות שאתם צריכים, התגובה תהיה קטנה יותר, ולכן היא תיטען מהר יותר ברשת.

מאפיינים
rows	סוג:  Array<RouteMatrixRow> השורות של המטריצה. כל שורה תואמת לנקודת מוצא ומכילה מערך של RouteMatrixItem, שכל אחד מהם מייצג מסלול ליעד.

Methods
toJSON	toJSON() פרמטרים:  אין ערך מוחזר:  Object המרת הנתונים לאובייקט.

הכיתה RouteMatrixRow

מחלקה google.maps.routes.RouteMatrixRow

תואם למקור שמועבר אל RouteMatrix.computeRouteMatrix. מכיל רשימה של RouteMatrixItem, כשכל פריט מייצג מסלול ליעד.

כדי לקבל גישה, צריך לקרוא ל: const {RouteMatrixRow} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

מאפיינים
items	סוג:  Array<RouteMatrixItem> פרטי המסלול לכל יעד.

Methods
toJSON	toJSON() פרמטרים:  אין ערך מוחזר:  Object המרת הנתונים לאובייקט.

המחלקה RouteMatrixItem

מחלקה google.maps.routes.RouteMatrixItem

מכיל מידע על מסלול שחושב עבור צמד של נקודת מוצא/יעד שהועבר אל RouteMatrix.computeRouteMatrix.

כדי לקבל גישה, צריך לקרוא ל: const {RouteMatrixItem} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

מאפיינים
condition	סוג:  RouteMatrixItemCondition optional מציין אם המסלול נמצא או לא.
distanceMeters	סוג:  number optional מרחק הנסיעה של המסלול במטרים.
durationMillis	סוג:  number optional משך הזמן שנדרש כדי לנווט במסלול, באלפיות השנייה. אם מגדירים את ComputeRouteMatrixRequest.routingPreference כ-TRAFFIC_UNAWARE, הערך הזה זהה ל-RouteMatrixItem.staticDurationMillis. אם מגדירים את ComputeRouteMatrixRequest.routingPreference לערך TRAFFIC_AWARE או TRAFFIC_AWARE_OPTIMAL, הערך הזה מחושב תוך התחשבות במצב התנועה. הערה: אם משך הזמן חורג מ-‎2^53 אלפיות השנייה, הערך הזה הוא Number.POSITIVE_INFINITY.
error	סוג:  RouteMatrixItemError optional שגיאה שהתרחשה במהלך חישוב המסלול.
fallbackInfo	סוג:  FallbackInfo optional במקרים מסוימים, כשהשרת לא יכול לחשב את המסלול עם ההעדפות שצוינו לצמד הספציפי הזה של נקודת המוצא והיעד, הוא עשוי לחזור להשתמש במצב חישוב אחר. כשמשתמשים ב-fallback, השדה הזה מכיל מידע מפורט על התגובה של ה-fallback. אחרת, השדה הזה לא מוגדר.
localizedValues	סוג:  RouteMatrixItemLocalizedValues optional ייצוגים בטקסט של מאפייני RouteMatrixItem.
staticDurationMillis	סוג:  number optional משך הנסיעה במסלול בלי להביא בחשבון את מצב התנועה. הערה: אם משך הזמן חורג מ-‎2^53 אלפיות השנייה, הערך הזה הוא Number.POSITIVE_INFINITY.
travelAdvisory	סוג:  RouteTravelAdvisory optional מידע נוסף על המסלול.

Methods
toJSON	toJSON() פרמטרים:  אין ערך מוחזר:  Object המרת הנתונים לאובייקט.

ממשק ComputeRouteMatrixRequest

ממשק google.maps.routes.ComputeRouteMatrixRequest

בקשה למטריצת מסלולים.

מאפיינים
destinations	סוג:  Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint> מערך של יעדים, שקובע את העמודות של מטריצת התגובה. ערך שמועבר כמחרוזת יכול להיות כתובת, Plus Code או שם של משאב מקום. ערכי הגובה לא נלקחים בחשבון.
fields	סוג:  Iterable<string> אוסף של שדות לאחזור. מציינים ["*"] בכל השדות.
origins	סוג:  Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|RouteMatrixOrigin|Waypoint> מערך של נקודות מוצא, שקובע את השורות של מטריצת התגובה. ערך שמועבר כמחרוזת יכול להיות כתובת, Plus Code או שם של משאב מקום. ערכי הגובה לא נלקחים בחשבון. יש כמה מגבלות גודל שחלות על העוצמה (cardinality) של נקודות המוצא והיעדים: המספר הכולל של נקודות המוצא והיעדים שצוינו כ-string או כ-Place לא יכול להיות גדול מ-50. המכפלה של מספר נקודות המוצא ומספר היעדים לא יכולה להיות גדולה מ-625. המכפלה של מספר נקודות המוצא והיעדים לא יכולה להיות גדולה מ-100 אם ComputeRouteMatrixRequest.routingPreference מוגדר ל-TRAFFIC_AWARE_OPTIMAL. המכפלה של מספר נקודות המוצא והיעדים לא יכולה להיות גדולה מ-100 אם ComputeRouteMatrixRequest.travelMode מוגדר ל-TRANSIT.
arrivalTime optional	סוג:  Date optional זמן ההגעה. הערה: אפשר להגדיר את המדיניות הזו רק אם המדיניות ComputeRouteMatrixRequest.travelMode מוגדרת לערך TRANSIT. אפשר לציין את ComputeRouteMatrixRequest.departureTime או את ComputeRouteMatrixRequest.arrivalTime, אבל לא את שניהם. אפשר לראות נסיעות בתחבורה ציבורית עד 7 ימים בעבר או עד 100 ימים בעתיד.
departureTime optional	סוג:  Date optional שעת היציאה. אם לא תגדירו את הערך הזה, המערכת תשתמש כברירת מחדל בחותמת הזמן של הבקשה. הערה: אפשר לציין זמן בעבר רק כשמגדירים את ComputeRouteMatrixRequest.travelMode כ-TRANSIT. אפשר לראות נסיעות בתחבורה ציבורית עד 7 ימים בעבר או עד 100 ימים בעתיד.
extraComputations optional	סוג:  Iterable<ComputeRouteMatrixExtraComputation> optional רשימה של חישובים נוספים שאפשר להשתמש בהם כדי להשלים את הבקשה. הערה: החישובים הנוספים האלה עשויים להחזיר שדות נוספים בתגובה. כדי שהשדות הנוספים האלה יוחזרו בתגובה, צריך לציין אותם גם ב-ComputeRouteMatrixRequest.fields.
language optional	סוג:  string optional קוד השפה בתקן BCP-47, למשל "en-US" או "sr-Latn". מידע נוסף זמין במאמר מזהה לוקאל של Unicode. כאן מפורטות השפות שבהן אפשר לקבל תמיכה. אם לא תציינו את הערך הזה, השפה תוסק מהגדרות הלוקליזציה של Google Maps JavaScript API. אחרת, השפה נקבעת לפי המיקום של המקור הראשון.
region optional	סוג:  string optional קוד האזור, שמוגדר כערך ccTLD (דומיין ברמה העליונה) באורך שני תווים. מידע נוסף זמין במאמר דומיינים ברמה העליונה עם קוד מדינה (ccTLD). אם לא תספקו את הערך הזה, האזור יוסק מהגדרות הלוקליזציה של Google Maps JavaScript API. אחרת, האזור נקבע לפי המיקום של המקור הראשון.
routingPreference optional	סוג:  RoutingPreference optional מציין איך לחשב את מטריצת המסלולים. השרת מנסה להשתמש בהעדפת המסלול שנבחרה כדי לחשב את מטריצת המסלולים. אם העדפת הניתוב גורמת לשגיאה או לזמן אחזור ארוך במיוחד, תוחזר שגיאה. אפשר לציין את האפשרות הזו רק כשהערך של ComputeRouteMatrixRequest.travelMode הוא DRIVING או TWO_WHEELER, אחרת הבקשה תיכשל.
trafficModel optional	סוג:  TrafficModel optional מציין את ההנחות שצריך להשתמש בהן כשמחשבים את הזמן בתנועה. ההגדרה הזו משפיעה על הערך שמוחזר ב-RouteMatrixItem.durationMillis, שמכיל את הזמן החזוי בתנועה על סמך ממוצעים היסטוריים. השדה ComputeRouteMatrixRequest.trafficModel זמין רק לבקשות שבהן השדה ComputeRouteMatrixRequest.routingPreference מוגדר כ-TRAFFIC_AWARE_OPTIMAL והשדה ComputeRouteMatrixRequest.travelMode מוגדר כ-DRIVING. ברירת המחדל היא BEST_GUESS.
transitPreference optional	סוג:  TransitPreference optional מציינת העדפות שמשפיעות על המסלול שמוחזר למסלולי TRANSIT. הערה: אפשר לציין את זה רק כש-ComputeRouteMatrixRequest.travelMode מוגדר ל-TRANSIT.
travelMode optional	סוג:  TravelMode optional מציין את אמצעי התחבורה.
units optional	סוג:  UnitSystem optional מציין את יחידות המידה של שדות התצוגה. אם לא תציינו את הערך הזה, יחידות התצוגה יוסקו מהמיקום של נקודת המוצא הראשונה.

קבועים של ComputeRouteMatrixExtraComputation

google.maps.routes.ComputeRouteMatrixExtraComputation קבועים

חישובים נוספים שצריך לבצע לבקשת RouteMatrix.computeRouteMatrix.

כדי לקבל גישה, צריך לקרוא ל: const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

קבועים
TOLLS	מידע על אגרות לפריטים במטריצה.

קבועים של RouteMatrixItemCondition

google.maps.routes.RouteMatrixItemCondition קבועים

מצב המסלול של צמד נתון של מוצא ויעד.

כדי לקבל גישה, צריך לקרוא ל: const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

קבועים
ROUTE_EXISTS	נמצא מסלול.
ROUTE_NOT_FOUND	לא נמצא מסלול.

מחלקה RouteMatrixItemError

מחלקה google.maps.routes.RouteMatrixItemError

שגיאה שאירעה במהלך RouteMatrix.computeRouteMatrix עבור צמד ספציפי של מקור/יעד.

המחלקה הזו מרחיבה את Error.

כדי לקבל גישה, צריך לקרוא ל: const {RouteMatrixItemError} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

Methods
toJSON	toJSON() פרמטרים:  אין ערך מוחזר:  Object המרת הנתונים לאובייקט.

המחלקה RouteMatrixItemLocalizedValues

מחלקה google.maps.routes.RouteMatrixItemLocalizedValues

ייצוגי טקסט של RouteMatrixItem.

כדי לקבל גישה, צריך לקרוא ל: const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

מאפיינים
distance	סוג:  string optional מרחק הנסיעה של הפריט במטריצת המסלולים, בפורמט טקסט.
distanceLanguage	סוג:  string optional קוד השפה בתקן BCP-47 של טקסט המרחק, למשל "en-US" או "sr-Latn". מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration	סוג:  string optional משך הזמן, מיוצג בפורמט טקסט ומותאם לאזור של השאילתה. לוקח בחשבון את מצב התנועה. הערה: אם לא ביקשתם מידע על התנועה, הערך הזה זהה לערך של RouteMatrixItemLocalizedValues.staticDuration.
durationLanguage	סוג:  string optional קוד השפה בתקן BCP-47 של טקסט משך הזמן, למשל "en-US" או "sr-Latn". מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration	סוג:  string optional משך הזמן בלי להביא בחשבון את מצב התנועה, מיוצג בפורמט טקסט.
staticDurationLanguage	סוג:  string optional קוד השפה בתקן BCP-47 של הטקסט הסטטי של משך הזמן, למשל "en-US" או "sr-Latn".
transitFare	סוג:  string optional תעריף הנסיעה, מיוצג בפורמט טקסט.
transitFareLanguage	סוג:  string optional קוד השפה בתקן BCP-47 של הטקסט של תעריף הנסיעה, למשל "en-US" או "sr-Latn". מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

Methods
toJSON	toJSON() פרמטרים:  אין ערך מוחזר:  Object המרת הנתונים לאובייקט.

ממשק RouteMatrixOrigin

ממשק google.maps.routes.RouteMatrixOrigin

מקור אחד ל-ComputeRouteMatrixRequest.

מאפיינים
waypoint	סוג:  string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint המיקום של נקודת המוצא. ערך שמועבר כמחרוזת יכול להיות כתובת או Plus Code. ערכי הגובה לא נלקחים בחשבון.
routeModifiers optional	סוג:  RouteModifiers optional מגדירי שינוי לכל מסלול שבו המיקום הזה הוא נקודת המוצא.