Distance Matrix

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

שיעור DISTANCEMatrixService

מחלקה google.maps.DistanceMatrixService

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

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

DistanceMatrixService
DistanceMatrixService()
פרמטרים: ללא
ליצירת מופע חדש של DistanceMatrixService ששולח מטריצות מרחקות אל שרתי Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
פרמטרים:
ערך החזרה: Promise<DistanceMatrixResponse>
יצירה של בקשת מטריצת מרחק.

הממשק של DISTANCEMatrixRequest

ממשק google.maps.DistanceMatrixRequest

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

destinations
מערך המכיל מחרוזות של כתובות יעד, או אובייקטים של LatLng או Place, שלפיהם יש לחשב את המרחק והזמן. חובה.
origins
מערך המכיל מחרוזות של כתובת מקור, או 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.map.importLibrary("routes") כדי לגשת אל v=beta. יש לעיין בספריות ב-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.map.importLibrary("routes") כדי לגשת אל v=beta. יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

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