Distance Matrix

‫DistanceMatrixService class

google.maps.DistanceMatrixService class

שירות לחישוב מרחקים בין כמה נקודות מוצא ליעדים.

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

יצרן
DistanceMatrixService	DistanceMatrixService() פרמטרים:  אין יוצרת מופע חדש של DistanceMatrixService ששולח שאילתות של מטריצת מרחקים לשרתים של Google.

Methods
getDistanceMatrix	getDistanceMatrix(request[, callback]) פרמטרים:  request:  DistanceMatrixRequest callback:  function(DistanceMatrixResponse optional, DistanceMatrixStatus): void optional ערך מוחזר:  Promise<DistanceMatrixResponse> שולח בקשה למטריצת מרחקים.

‫DistanceMatrixRequest interface

google.maps.DistanceMatrixRequest ממשק

שאילתת מטריצת מרחקים שנשלחת על ידי DistanceMatrixService ומכילה מערכים של מיקומי מוצא ויעד, ואפשרויות שונות לחישוב מדדים.

מאפיינים
destinations	סוג:  Array<string|LatLng|LatLngLiteral|Place> מערך שמכיל מחרוזות של כתובות יעד, או LatLng, או אובייקטים של Place, שלפיהם יחושבו המרחק והזמן. חובה.
origins	סוג:  Array<string|LatLng|LatLngLiteral|Place> מערך שמכיל מחרוזות של כתובות מוצא, או LatLng, או אובייקטים של Place, שממנו יחושבו המרחק והזמן. חובה.
travelMode	סוג:  TravelMode סוג הניתוב המבוקש. חובה.
avoidFerries optional	סוג:  boolean optional אם מציינים את הערך true, שירות מטריצת המרחקים ינסה להימנע משימוש במעבורות ככל האפשר. אופציונלי.
avoidHighways optional	סוג:  boolean optional אם true, שירות מטריצת המרחקים ינסה להימנע מכבישים מהירים ככל האפשר. אופציונלי.
avoidTolls optional	סוג:  boolean optional אם true, שירות מטריצת המרחקים ינסה להימנע מכבישי אגרה. אופציונלי.
drivingOptions optional	סוג:  DrivingOptions optional הגדרות שחלות רק על בקשות שבהן travelMode הוא DRIVING. לאובייקט הזה לא תהיה השפעה על אמצעי תחבורה אחרים.
language optional	סוג:  string optional מזהה שפה של השפה שבה צריך להחזיר את התוצאות, אם אפשר. כאן אפשר לעיין ברשימת השפות הנתמכות.
region optional	סוג:  string optional קוד אזור שמשמש כהטיה לבקשות לגיאו-קידוד. קוד האזור יכול להיות ccTLD (דומיין ברמה העליונה) באורך שני תווים. רוב קודי ה-ccTLD זהים לקודי ISO 3166-1, אבל יש כמה יוצאים מן הכלל. לדוגמה, דומיין ccTLD של בריטניה הוא uk (.co.uk), אבל קוד ISO 3166-1 שלה הוא gb (מבחינה טכנית, עבור הישות 'ממלכת בריטניה הגדולה וצפון אירלנד').
transitOptions optional	סוג:  TransitOptions optional הגדרות שחלות רק על בקשות שבהן travelMode הוא TRANSIT. לאובייקט הזה לא תהיה השפעה על אמצעי תחבורה אחרים.
unitSystem optional	סוג:  UnitSystem optional מערכת היחידות המועדפת לשימוש בהצגת מרחק. אופציונלי; ברירת המחדל היא metric.

‫DistanceMatrixResponse interface

google.maps.DistanceMatrixResponse ממשק

התשובה לבקשת DistanceMatrixService, שכוללת את כתובות המוצא והיעד בפורמט, ורצף של DistanceMatrixResponseRow, אחד לכל כתובת מוצא תואמת.

מאפיינים
destinationAddresses	סוג:  Array<string> כתובות היעד בפורמט המתאים.
originAddresses	סוג:  Array<string> כתובות המקור בפורמט המתאים.
rows	סוג:  Array<DistanceMatrixResponseRow> השורות של המטריצה, שמתאימות לכתובות המקור.

‫DistanceMatrixResponseRow interface

google.maps.DistanceMatrixResponseRow ממשק

שורה בתשובה לבקשת DistanceMatrixService, שמורכבת מרצף של DistanceMatrixResponseElement, אחד לכל כתובת יעד תואמת.

מאפיינים
elements	סוג:  Array<DistanceMatrixResponseElement> הרכיבים בשורה, שמתאימים לכתובות היעד.

‫DistanceMatrixResponseElement interface

google.maps.DistanceMatrixResponseElement ממשק

רכיב יחיד בתגובה לבקשת DistanceMatrixService, שמכיל את משך הזמן והמרחק מנקודת מוצא אחת לנקודת יעד אחת.

מאפיינים
distance	סוג:  Distance המרחק בין נקודת המוצא ליעד. יכול להיות שהמאפיין הזה לא יוגדר כי יכול להיות שהמרחק לא ידוע.
duration	סוג:  Duration משך הזמן של צמד המקור והיעד הזה. יכול להיות שהמאפיין הזה לא יוגדר כי משך הזמן לא ידוע.
duration_in_traffic	סוג:  Duration משך הזמן של צמד המקור והיעד הזה, תוך התחשבות בתנאי התנועה שמצוינים במאפיין trafficModel. יכול להיות שהערך של המאפיין הזה יהיה undefined כי יכול להיות שהמשך לא ידוע. האפשרות הזו זמינה רק ללקוחות Premium Plan, כשמוגדר drivingOptions בזמן שליחת הבקשה.
fare	סוג:  TransitFare המחיר הכולל של צמד היעד והמוצא הזה. המאפיין הזה רלוונטי רק לבקשות שקשורות לתחבורה ציבורית.
status	סוג:  DistanceMatrixElementStatus הסטטוס של צמד המוצא והיעד הספציפי הזה.

DistanceMatrixStatus constants

google.maps.DistanceMatrixStatus constants

הסטטוס ברמה העליונה לגבי הבקשה באופן כללי, שמוחזר על ידי DistanceMatrixService עם השלמת בקשה של מטריצת מרחקים. אפשר לציין אותם לפי ערך או באמצעות שם הקבוע. לדוגמה, 'OK' או google.maps.DistanceMatrixStatus.OK.

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

Constants
INVALID_REQUEST	הבקשה שסופקה לא תקינה.
MAX_DIMENSIONS_EXCEEDED	הבקשה מכילה יותר מ-25 מקורות או יותר מ-25 יעדים.
MAX_ELEMENTS_EXCEEDED	המכפלה של מספר המקורות ומספר היעדים חורגת מהמגבלה לכל שאילתה.
OK	התשובה מכילה תוצאה תקינה.
OVER_QUERY_LIMIT	נשלחו יותר מדי בקשות בפרק זמן קצר מדי. אם תנסו שוב אחרי זמן מה, הבקשה אמורה להצליח.
REQUEST_DENIED	השירות דחה את השימוש בשירות Distance Matrix בדף האינטרנט שלכם.
UNKNOWN_ERROR	לא ניתן לעבד בקשה של מטריצת מרחקים בגלל שגיאה בחיבור לשרת. אם תנסו שוב, יכול להיות שהבקשה תצליח.

DistanceMatrixElementStatus קבועים

google.maps.DistanceMatrixElementStatus constants

הסטטוס ברמת הרכיב לגבי זוג מסוים של מקור ויעד שמוחזר על ידי DistanceMatrixService עם השלמת בקשה של מטריצת מרחקים. הערכים האלה מצוינים כמחרוזות, למשל, 'OK'.

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

Constants
NOT_FOUND	לא הייתה אפשרות לבצע קידוד גיאוגרפי של המקור או היעד של הצמד הזה.
OK	התשובה מכילה תוצאה תקינה.
ZERO_RESULTS	לא נמצא מסלול בין נקודת המוצא ליעד.