Distance Matrix

המחלקה DistanceMatrixService

google.maps.DistanceMatrixService סיווג

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

ניתן לגשת באמצעות חיוג אל const {DistanceMatrixService} = await google.maps.importLibrary("routes"). ראה ספריות ב-Maps JavaScript API.
DistanceMatrixService
DistanceMatrixService()
פרמטרים: ללא
הפונקציה יוצרת מכונה חדשה של DistanceMatrixService ששולחת שאילתות על מטריצת מרחקים לשרתים של Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
פרמטרים: 
הערך המוחזר:  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
השורות של המטריצה, שתואמות לכתובות המקור.

ממשק DistanceMatrixResponseRow

ממשק google.maps.DistanceMatrixResponseRow

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

ממשק DistanceMatrixResponseElement

ממשק google.maps.DistanceMatrixResponseElement

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

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

קבועים של DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus קבועים

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

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