Distance Matrix

שיעור DISTANCEMatrixService

מחלקה google.maps.DistanceMatrixService

שירות לחישוב מרחקים בין מקורות ויעדים מרובים.

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

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

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

ממשק 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"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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

קבועים של DISTANCEMatrixElementStatus

google.maps.DistanceMatrixElementStatus קבועים

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

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

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