Distance Matrix

הכיתה DistanceMatrixService

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

ממשק 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, המערכת תורה לשירות Distance Matrix להימנע מכבישי אגרה במידת האפשר. זה שינוי אופציונלי.
drivingOptions optional	סוג:  DrivingOptions optional הגדרות שחלות רק על בקשות שבהן הערך של travelMode הוא DRIVING. לא תהיה לאובייקט הזה השפעה על שיטות נסיעה אחרות.
language optional	סוג:  string optional מזהה שפה של השפה שבה צריך להציג את התוצאות, כשהדבר אפשרי. כאן אפשר לעיין ברשימת השפות הנתמכות.
region optional	סוג:  string optional קוד האזור שמשמש כנטייה לטובת בקשות לגיאוקודציה. קוד האזור יכול להכיל ערך בן שני תווים של דומיין ברמה עליונה עם קוד מדינה (ccTLD). רוב הקודים של הדומיינים ברמה הלאומית זהים לקודי ISO 3166-1, מלבד כמה יוצאים מן הכלל. לדוגמה, הדומיין ברמה העליונה של בריטניה הוא 'uk' (.co.uk), ואילו הקוד שלה ב-ISO 3166-1 הוא 'gb' (טכנית, עבור הישות 'ממלכת בריטניה הגדולה וצפון אירלנד').
transitOptions optional	סוג:  TransitOptions optional הגדרות שחלות רק על בקשות שבהן הערך של travelMode הוא TRANSIT. לא תהיה לאובייקט הזה השפעה על שיטות נסיעה אחרות.
unitSystem optional	סוג:  UnitSystem optional מערכת היחידות המועדפת לשימוש כשמציגים מרחק. אופציונלי. ברירת המחדל היא 'מדד'.

הממשק DistanceMatrixResponse

ממשק google.maps.DistanceMatrixResponse

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

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

הממשק DistanceMatrixResponseRow

ממשק google.maps.DistanceMatrixResponseRow

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

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

הממשק DistanceMatrixResponseElement

ממשק google.maps.DistanceMatrixResponseElement

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

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

קבועים של DistanceMatrixStatus

google.maps.DistanceMatrixStatus קבועים

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

אפשר לגשת אליו באמצעות חיוג למספר const {DistanceMatrixStatus} = await google.maps.importLibrary("routes"). ספריות ב-Maps JavaScript API

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

קבועים של DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus קבועים

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

אפשר לגשת אליו באמצעות חיוג למספר const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes"). ספריות ב-Maps JavaScript API

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