Route Matrix (beta)

‫RouteMatrix class

google.maps.routes.RouteMatrix class

הערה: התכונה זמינה רק בערוץ v=beta.

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

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

Static Methods

computeRouteMatrix

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

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

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

‫RouteMatrixRow class

google.maps.routes.RouteMatrixRow class

הערה: התכונה זמינה רק בערוץ v=beta.

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

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

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

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

‫RouteMatrixItem class

google.maps.routes.RouteMatrixItem class

הערה: התכונה זמינה רק בערוץ v=beta.

מכיל מידע על מסלול שמחושב עבור צמד של מוצא ויעד שמועבר אל 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 במקרים מסוימים, אם השרת לא מצליח לחשב את המסלול עם ההעדפות שצוינו עבור זוג מסוים של נקודת מוצא ויעד, הוא עשוי לחזור לחישוב באמצעות מצב חישוב אחר. כשנעשה שימוש בגיבוי, השדה הזה מכיל מידע מפורט על תגובת הגיבוי. אחרת, השדה הזה לא מוגדר.
localizedValues	סוג:  RouteMatrixItemLocalizedValues optional ייצוגים של מאפיינים של RouteMatrixItem בצורת טקסט.
staticDurationMillis	סוג:  number optional משך הנסיעה במסלול בלי להתחשב במצב התנועה. הערה: אם משך הזמן ארוך מ-2^53 מילישניות, הערך הזה הוא Number.POSITIVE_INFINITY.
travelAdvisory	סוג:  RouteTravelAdvisory optional מידע נוסף על המסלול.

ממשק ComputeRouteMatrixRequest

google.maps.routes.ComputeRouteMatrixRequest ממשק

הערה: התכונה זמינה רק בערוץ v=beta.

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

מאפיינים
destinations	סוג:  Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|Waypoint> מערך של יעדים, שקובע את העמודות של מטריצת התגובה. ערך שמועבר כמחרוזת יכול להיות כתובת, קוד פלוס או שם של משאב Place. המערכת לא לוקחת בחשבון את ערכי הגובה.
fields	סוג:  Iterable<string> אוסף של שדות לאחזור. מציינים ["*"] לכל השדות.
origins	סוג:  Iterable<string|LatLng|LatLngLiteral|LatLngAltitudeLiteral|DirectionalLocationLiteral|Place|RouteMatrixOrigin|Waypoint> מערך של מקורות, שקובע את השורות של מטריצת התגובה. ערך שמועבר כמחרוזת יכול להיות כתובת, קוד פלוס או שם של משאב Place. המערכת לא לוקחת בחשבון את ערכי הגובה. יש כמה הגבלות על הגודל של העוצמה של מקורות ויעדים: המספר הכולל של נקודות המוצא והיעדים שצוינו כ-string או כ-Place לא יכול להיות גדול מ-50. המכפלה של מספר נקודות המוצא ומספר היעדים לא יכולה להיות גדולה מ-625. אם הערך של ComputeRouteMatrixRequest.routingPreference הוא TRAFFIC_AWARE_OPTIMAL, המכפלה של מספר נקודות המוצא ומספר היעדים לא יכולה להיות גדולה מ-100. אם הערך של ComputeRouteMatrixRequest.travelMode הוא TRANSIT, המכפלה של מספר נקודות המוצא ומספר היעדים לא יכולה להיות גדולה מ-100.
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 Locale Identifier. כאן אפשר לעיין ברשימת השפות הנתמכות. אם לא מציינים את הערך הזה, השפה נקבעת לפי הגדרות הלוקליזציה של Google Maps JavaScript API. אחרת, השפה נקבעת לפי המיקום של המקור הראשון.
region optional	סוג:  string optional קוד האזור, שמוגדר כערך 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 constants

google.maps.routes.ComputeRouteMatrixExtraComputation constants

הערה: התכונה זמינה רק בערוץ v=beta.

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

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

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

RouteMatrixItemCondition constants

google.maps.routes.RouteMatrixItemCondition constants

הערה: התכונה זמינה רק בערוץ v=beta.

התנאי של מסלול לזוג נתון של מוצא/יעד.

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

Constants
ROUTE_EXISTS	נמצא מסלול.
ROUTE_NOT_FOUND	לא נמצא מסלול.

‫RouteMatrixItemError class

google.maps.routes.RouteMatrixItemError class

הערה: התכונה זמינה רק בערוץ v=beta.

שגיאה שהתרחשה במהלך RouteMatrix.computeRouteMatrix עבור זוג מסוים של מקור/יעד.

הכיתה הזו היא הרחבה של Error.

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

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

‫RouteMatrixItemLocalizedValues class

google.maps.routes.RouteMatrixItemLocalizedValues class

הערה: התכונה זמינה רק בערוץ v=beta.

ייצוגים של 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 interface

google.maps.routes.RouteMatrixOrigin ממשק

הערה: התכונה זמינה רק בערוץ v=beta.

מקור יחיד ל-ComputeRouteMatrixRequest.

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