Package google.maps.isochrones.v1

אינדקס

IsochroneService

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

GenerateIsochrone

rpc GenerateIsochrone(GenerateIsochroneRequest) returns (GenerateIsochroneResponse)

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

GenerateIsochroneRequest

בקשה ליצירת איזוכרון יחיד.

שדות
travel_duration

Duration

חובה. זמן הנסיעה לחישוב האיזוֹכרוֹן. הערך חייב להיות חיובי, והוא מוגבל ל-7,200 שניות (120 דקות). במצב DRIVE, משך הזמן המקסימלי המותר הוא 3,600 שניות (60 דקות).
travel_mode

TravelMode

חובה. אמצעי התחבורה.
travel_direction

TravelDirection

חובה. כיוון הנסיעה.
routing_preference

RoutingPreference

אופציונלי. מציינת את ההעדפה לגבי אופן הניתוב. ברירת המחדל היא TRAFFIC_UNAWARE.
enable_smoothing

bool

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

PolygonFidelity

אופציונלי. ההגדרה הזו קובעת את רמת הדיוק של הפוליגון שנוצר. ברירת המחדל היא POLYGON_FIDELITY_UNSPECIFIED.
שדה איחוד origin. חובה. נקודת ההתחלה לחישוב האיזוֹכרוֹן. הערך origin יכול להיות רק אחד מהבאים:
location

LatLng

נקודת המוצא כקואורדינטה של קו רוחב/אורך.
place

string

שם המשאב של המקום, בפורמט places/{place_id}.

PolygonFidelity

קובע את רמת הפירוט במצולע האיזוֹכרוֹני.

טיפוסים בני מנייה (enum)
POLYGON_FIDELITY_UNSPECIFIED לא צוינה רמת דיוק של פוליגון. השרת ישתמש בברירת המחדל שלו, שמבוססת על משך הנסיעה.
LOW רמת דיוק נמוכה. מתאים לכיסוי אזורים גדולים עם פחות קודקודים.
MEDIUM רמת דיוק בינונית. איזון בין רמת הפירוט לבין גודל הארטיפקט.
HIGH רמת דיוק גבוהה. קצוות ברמת דיוק גבוהה, אבל יכול להיות שייווצרו חורים בפוליגון במקומות שבהם צפיפות רשת הכבישים נמוכה.

RoutingPreference

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

טיפוסים בני מנייה (enum)
ROUTING_PREFERENCE_UNSPECIFIED לא צוינה העדפה לניתוב. השרת ישתמש בברירת המחדל שלו, שהיא TRAFFIC_UNAWARE.
TRAFFIC_UNAWARE החישוב לא יתחשב בתנאי התנועה. קו האיזוכרון יתבסס על רשת הכבישים ועל זמני נסיעה סטטיים. זה מתאים למטרות תכנון שבהן התנועה לא מהווה גורם.
TRAFFIC_AWARE החישוב יתבסס על מצב התנועה בזמן אמת.

TravelDirection

מציינת את כיוון הנסיעה לחישוב האיזוֹכרוֹן.

טיפוסים בני מנייה (enum)
TRAVEL_DIRECTION_UNSPECIFIED לא צוין כיוון נסיעה.
FROM חישוב האזור שאפשר להגיע אליו מנקודת המוצא. דוגמה: "לאיזה אזור אפשר לספק משלוח מהמחסן שלי תוך 30 דקות?"
TO חישוב השטח שממנו אפשר להגיע אל נקודת המוצא. דוגמה: "מאיפה העובדים שלי יכולים להגיע למשרד בנסיעה של 30 דקות?"

TravelMode

הגדרה של אמצעי התחבורה לחישוב איזוכרונה.

טיפוסים בני מנייה (enum)
TRAVEL_MODE_UNSPECIFIED לא צוין מצב נסיעה.
DRIVE נסיעה ברכב נוסעים.
BICYCLE נסיעה באופניים.
WALK לנסוע בהליכה.

GenerateIsochroneResponse

תשובה שמכילה את נתוני האיזוֹכרוֹן שנוצרו.

שדות
isochrone

Isochrone

פלט בלבד. האיזוכרון שנוצר.

קו איזוכרוני

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

שדות
שדה איחוד geometry. הייצוג הגיאומטרי של קו הזמן. הערך geometry יכול להיות רק אחד מהבאים:
geo_json

Struct

הגיאומטריה של האיזוֹכרוֹנה בפורמט GeoJSON, בפורמט RFC 7946: ‏ https://datatracker.ietf.org/doc/html/rfc7946#section-3.1.6.