Route Matrix (beta)

‫RouteMatrix class

google.maps.routes.RouteMatrix class

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

אפשר להתקשר אל const {RouteMatrix} = await google.maps.importLibrary("routes") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.
computeRouteMatrix
computeRouteMatrix(request)
פרמטרים: 
ערך מוחזר:  Promise<{matrix:RouteMatrix}>
הפונקציה מקבלת רשימה של מקורות ויעדים ומחזירה מטריצה שמכילה מידע על המסלול לכל שילוב של מקור ויעד.

הערה: בשיטה הזו צריך לציין מסכת שדות של תגובה בבקשה על ידי הגדרת המאפיין ComputeRouteMatrixRequest.fields. הערך הוא רשימה של נתיבי שדות.

לדוגמה:
  • אנונימיזציה של כל השדות הזמינים: fields: ['*']
  • אנונימיזציה של שדות של משך ומרחק ברמת המסלול: fields: ['durationMillis', 'distanceMeters']

לא מומלץ להשתמש באנונימיזציה של שדות תגובה עם תו כללי לחיפוש fields: ['*'] כי:
  • בחירה רק של השדות שאתם צריכים עוזרת לשרת שלנו לחסוך במחזורי חישוב, וכך אנחנו יכולים להחזיר לכם את התוצאה עם זמן אחזור נמוך יותר.
  • בחירה רק של השדות שאתם צריכים בעבודת הייצור מבטיחה ביצועים יציבים של זמן האחזור. יכול להיות שבעתיד נוסיף עוד שדות תשובה, והשדות החדשים האלה עשויים לדרוש זמן חישוב נוסף. אם תבחרו את כל השדות, או את כל השדות ברמה העליונה, יכול להיות שתחוו ירידה בביצועים כי כל שדה חדש שנוסיף ייכלל אוטומטית בתשובה.
  • בחירה רק של השדות שאתם צריכים מובילה לגודל תגובה קטן יותר, ולכן לטעינה מהירה יותר ברשת.
rows
השורות של המטריצה. כל שורה מתאימה למקור ומכילה מערך של RouteMatrixItems, שכל אחד מהם מייצג נתיב ליעד.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
הפונקציה ממירה לאובייקט.

‫RouteMatrixRow class

google.maps.routes.RouteMatrixRow class

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

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

‫RouteMatrixItem class

google.maps.routes.RouteMatrixItem class

מכיל מידע על מסלול שמחושב עבור צמד של מוצא ויעד שמועבר אל 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
ייצוגים של מאפיינים של RouteMatrixItem בצורת טקסט.
staticDurationMillis
סוג:  number optional
משך הנסיעה במסלול בלי להתחשב במצב התנועה.

הערה: אם משך הזמן ארוך מ-2^53 מילישניות, הערך הזה הוא Number.POSITIVE_INFINITY.
travelAdvisory
סוג:  RouteTravelAdvisory optional
מידע נוסף על המסלול.

ממשק ComputeRouteMatrixRequest

google.maps.routes.ComputeRouteMatrixRequest ממשק

בקשה למטריצת מסלולים.
destinations
מערך של יעדים, שקובע את העמודות של מטריצת התגובה. ערך שמועבר כמחרוזת יכול להיות כתובת, קוד פלוס או שם של משאב Place. המערכת לא לוקחת בחשבון את ערכי הגובה.
fields
סוג:  Iterable<string>
אוסף של שדות לאחזור. מציינים ["*"] לכל השדות.
origins
מערך של מקורות, שקובע את השורות של מטריצת התגובה. ערך שמועבר כמחרוזת יכול להיות כתובת, קוד פלוס או שם של משאב 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
רשימה של חישובים נוספים שאפשר להשתמש בהם כדי להשלים את הבקשה.

הערה: יכול להיות שהחישובים הנוספים האלה יחזירו שדות נוספים בתגובה. כדי שהשדות הנוספים האלה יוחזרו בתגובה, צריך לציין אותם גם ב-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

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

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

RouteMatrixItemCondition constants

google.maps.routes.RouteMatrixItemCondition constants

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

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

‫RouteMatrixItemError class

google.maps.routes.RouteMatrixItemError class

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

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

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

‫RouteMatrixItemLocalizedValues class

google.maps.routes.RouteMatrixItemLocalizedValues class

ייצוגים של 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.
toJSON
toJSON()
פרמטרים:  אין
ערך מוחזר:  Object
הפונקציה ממירה לאובייקט.

‫RouteMatrixOrigin interface

google.maps.routes.RouteMatrixOrigin ממשק

מקור יחיד ל-ComputeRouteMatrixRequest.
waypoint
המיקום של המקור. ערך שמועבר כמחרוזת יכול להיות כתובת או קוד פלוס. המערכת לא לוקחת בחשבון את ערכי הגובה.
routeModifiers optional
סוג:  RouteModifiers optional
משנים את כל המסלולים שמתחילים בנקודה הזו.