- משאב: רכב
- VehicleState
- VehicleAttribute
- VehicleType
- קטגוריה
- LicensePlate
- TrafficPolylineData
- VisualTrafficReportPolylineRendering
- RoadStretch
- סגנון
- NavigationStatus
- DeviceSettings
- LocationPowerSaveMode
- BatteryInfo
- BatteryStatus
- PowerSource
- שיטות
משאב: רכב
מטא-נתונים של הרכב.
ייצוג ב-JSON |
---|
{ "name": string, "vehicleState": enum ( |
שדות | |
---|---|
name |
פלט בלבד. השם הייחודי של הרכב. הפורמט הוא |
vehicle |
מצב הרכב. |
supported |
סוגי הנסיעות שנתמכים ברכב הזה. |
current |
פלט בלבד. רשימת אפליקציות של |
last |
המיקום המדווח האחרון של הרכב. |
maximum |
מספר הנוסעים הכולל ברכב הזה. הנהג לא נלקח בחשבון בערך הזה. הערך חייב להיות גדול מ-1 או שווה לו. |
attributes[] |
רשימת מאפייני הרכב. לרכב אפשר להזין עד 100 מאפיינים, ולכל מאפיין צריך להיות מפתח ייחודי. |
vehicle |
חובה. סוג הרכב הזה. אפשר להשתמש בו לסינון רכבים בתוצאות של |
license |
פרטי לוחית הרישוי של הרכב. |
route[] |
הוצא משימוש: במקומו צריך להשתמש ברכיב |
current |
הקו הפוליגוני שמציין את המסלול שאפליקציית הנהג מתכוונת לעבור אל ציון הדרך הבא. הרשימה הזו מוחזר גם ב- הערה: השדה הזה מיועד לשימוש רק ב-Driver SDK. עדיין אין תמיכה בפענוח. |
current |
קלט בלבד. Fleet Engine משתמש במידע הזה כדי לשפר את שיתוף הנסיעות. הערה: השדה הזה מיועד לשימוש רק ב-Driver SDK. |
current |
פלט בלבד. השעה שבה חותמת זמן בפורמט UTC 'Zulu' של RFC3339, עם רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: |
current |
נקודת הציון שבה מסתיים |
remaining |
המרחק שנותר לנסיעה ב- |
eta |
זמן ההגעה המשוער (ETA) לרשומה הראשונה בשדה כשמעדכנים רכב, הערך של חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: |
remaining |
קלט בלבד. משך הנסיעה שנותר ב- כשמעדכנים רכב, |
waypoints[] |
שאר נקודות הדרך שהוקצו לרכב הזה. |
waypoints |
פלט בלבד. הפעם האחרונה שהשדה חותמת זמן בפורמט 'Zulu' בפורמט RFC3339 UTC, עם רזולוציה של ננו-שנייה ועד תשע ספרות אחרי הנקודה. דוגמאות: |
back |
השדה הזה מציין אם הנהג/ת מאשר/ת נסיעות הלוך ושוב. אם |
navigation |
סטטוס הניווט של הרכב. |
device |
קלט בלבד. מידע על ההגדרות במכשיר הנייד שמשמש את הנהג/ת. |
VehicleState
המצב של Vehicle
.
טיפוסים בני מנייה (enum) | |
---|---|
UNKNOWN_VEHICLE_STATE |
ברירת מחדל, משמשת למצבים של רכבים שלא צוינו או לא מזוהים. |
OFFLINE |
הרכב לא מקבל נסיעות חדשות. הערה: יכול להיות שהרכב ימשיך לפעול במצב הזה במהלך נסיעה שהוקצתה לו. |
ONLINE |
ניתן לאשר נסיעות חדשות ברכב. |
VehicleAttribute
מתאר מאפיין רכב כצמד מפתח/ערך. אורך המחרוזת 'key:value' לא יכול לחרוג מ-256 תווים.
ייצוג ב-JSON |
---|
{ "key": string, "value": string, // Union field |
שדות | |
---|---|
key |
המַּפתח של המאפיין. מפתחות לא יכולים להכיל את התו פסיק נקודה (:). |
value |
ערך המאפיין. |
שדה איחוד vehicle_attribute_value . ערך המאפיין יכול להיות מחרוזת, בוליאני או סוג כפול. vehicle_attribute_value יכול להיות רק אחת מהאפשרויות הבאות: |
|
string |
ערך מאפיין שהוקלד במחרוזת. הערה: השדה הזה זהה לשדה |
bool |
ערך מאפיין מסוג בוליאני. |
number |
ערך המאפיין הוקלד פעמיים. |
VehicleType
סוג הרכב.
ייצוג JSON |
---|
{
"category": enum ( |
שדות | |
---|---|
category |
קטגוריית סוג הרכב |
קטגוריה
קטגוריות של סוגי כלי רכב
טיפוסים בני מנייה (enum) | |
---|---|
UNKNOWN |
ברירת מחדל, משמשת לקטגוריות רכב שלא צוינו או לא מזוהות. |
AUTO |
מכונית. |
TAXI |
כל כלי רכב שמשמש כמונית (בדרך כלל ברישיון או בפיקוח). |
TRUCK |
באופן כללי, רכב עם קיבולת אחסון גדולה. |
TWO_WHEELER |
אופנוע, טוסטוס או כלי רכב דו-גלגלי אחר |
BICYCLE |
תחבורה מונעת על ידי אדם. |
PEDESTRIAN |
כלי רכב בני אדם, שבדרך כלל הולכים או רצים, נעשים לאורך שבילים להולכי רגל. |
LicensePlate
פרטי לוחית הרישוי של הרכב. כדי להימנע מאחסון פרטים אישיים מזהים, רק המידע המינימלי על לוחית הרישוי מאוחסן כחלק מהישות.
ייצוג JSON |
---|
{ "countryCode": string, "lastCharacter": string } |
שדות | |
---|---|
country |
חובה. קוד המדינה או האזור במאגר CLDR. לדוגמה, |
last |
הספרה האחרונה של לוחית הרישוי או '-1' כדי לציין שאין ערך מספרי בלוחית הרישוי.
|
TrafficPolylineData
מצב התנועה לאורך מסלול הרכב הצפוי.
ייצוג JSON |
---|
{
"trafficRendering": {
object ( |
שדות | |
---|---|
traffic |
רינדור של קו פוליגוני שמציג את מהירות התנועה בכל האזורים במקטע אחד של נסיעה של לקוח. |
VisualTrafficReportPolylineRendering
מתאר כיצד לקוחות צריכים לצבוע חלק אחד מהקו הפוליגוני לאורך הנתיב.
ייצוג JSON |
---|
{
"roadStretch": [
{
object ( |
שדות | |
---|---|
road |
זה שינוי אופציונלי. קטעי דרך שאמורים להיות מוצגים לאורך קו פוליגוני. מתיחות מובטחות שלא יחפפו, והן לא בהכרח מכסות את המסלול המלא. אם אין קטע כביש שאפשר להגדיר לו סגנון, הלקוח צריך להחיל את ברירת המחדל של המסלול. |
RoadStretch
מקטע אחד של כביש שצריך להציג.
ייצוג JSON |
---|
{
"style": enum ( |
שדות | |
---|---|
style |
חובה. הסגנון שרוצים להחיל. |
offset |
חובה. צריך להחיל את הסגנון בין התאריכים |
length |
חובה. אורך הנתיב שבו צריך להחיל את הסגנון. |
סגנון
סגנון התנועה, שמציין את מהירות התנועה.
טיפוסים בני מנייה (enum) | |
---|---|
STYLE_UNSPECIFIED |
לא נבחר סגנון. |
SLOWER_TRAFFIC |
התנועה מאטה. |
TRAFFIC_JAM |
יש פקק תנועה. |
DeviceSettings
מידע על הגדרות שונות במכשיר הנייד.
ייצוג ב-JSON |
---|
{ "locationPowerSaveMode": enum ( |
שדות | |
---|---|
location |
איך מוגדרות תכונות המיקום במכשיר כשמצב החיסכון בסוללה מופעל. |
is |
אם המכשיר נמצא כרגע במצב חיסכון בסוללה. |
is |
אם המכשיר במצב אינטראקטיבי. |
battery |
מידע על מצב הסוללה. |
LocationPowerSaveMode
איך תכונות המיקום מוגדרות כך שיפעלו בנייד כשהתכונה 'חיסכון בסוללה' מופעלת במכשיר. (https://developer.android.com/reference/android/os/PowerManager#getLocationPowerSaveMode())
טיפוסים בני מנייה (enum) | |
---|---|
UNKNOWN_LOCATION_POWER_SAVE_MODE |
LocationPowerSaveMode לא מוגדר |
LOCATION_MODE_NO_CHANGE |
מצב חיסכון בסוללה לא אמור להשפיע על ספקי המיקום, או שהוא מושבת. |
LOCATION_MODE_GPS_DISABLED_WHEN_SCREEN_OFF |
יש להשבית את ספק המיקום המבוסס על GPS כשמצב חיסכון בסוללה מופעל והמכשיר לא אינטראקטיבי. |
LOCATION_MODE_ALL_DISABLED_WHEN_SCREEN_OFF |
צריך להשבית את כל ספקי המיקום כשמצב החיסכון בסוללה מופעל והמכשיר לא אינטראקטיבי. |
LOCATION_MODE_FOREGROUND_ONLY |
כל ספקי המיקום ימשיכו להיות זמינים, אבל יש לספק תיקוני מיקום רק לאפליקציות שפועלות בחזית. |
LOCATION_MODE_THROTTLE_REQUESTS_WHEN_SCREEN_OFF |
התכונה 'מיקום' לא תושבת, אבל מנהל המיקום ויסות את כל הבקשות לספקים כשהמכשיר לא אינטראקטיבי. |
BatteryInfo
מידע על הסוללה של המכשיר.
ייצוג ב-JSON |
---|
{ "batteryStatus": enum ( |
שדות | |
---|---|
battery |
סטטוס הסוללה, אם היא מלאה או נטענת וכו'. |
power |
סטטוס מקור החשמל של הסוללה. |
battery |
אחוז הטעינה הנוכחי של הסוללה [0-100]. |
BatteryStatus
סטטוס הסוללה, אם היא מלאה או נטענת וכו'.
טיפוסים בני מנייה (enum) | |
---|---|
UNKNOWN_BATTERY_STATUS |
מצב הסוללה לא ידוע. |
BATTERY_STATUS_CHARGING |
הסוללה נטענת. |
BATTERY_STATUS_DISCHARGING |
הסוללה פורקת. |
BATTERY_STATUS_FULL |
הסוללה מלאה. |
BATTERY_STATUS_NOT_CHARGING |
הסוללה לא נטענת. |
BATTERY_STATUS_POWER_LOW |
הסוללה חלשה. |
PowerSource
סוג המטען שמשמש לטעינת הסוללה.
טיפוסים בני מנייה (enum) | |
---|---|
UNKNOWN_POWER_SOURCE |
מקור החשמל לא ידוע. |
POWER_SOURCE_AC |
מקור החשמל הוא מטען לחשמל. |
POWER_SOURCE_USB |
מקור החשמל הוא יציאת USB. |
POWER_SOURCE_WIRELESS |
מקור הכוח הוא אלחוטי. |
POWER_SOURCE_UNPLUGGED |
הסוללה לא מחוברת. |
שיטות |
|
---|---|
|
יוצרים כלי רכב חדש שמשויך לספקי משלוחים או נסיעות על פי דרישה. |
|
מחזירה רכב מ-Fleet Engine. |
|
הפונקציה מחזירה רשימה מקטעי של כלי רכב שמשויכים לספק שתואמים לאפשרויות הבקשה. |
|
הפונקציה מחזירה רשימה של כלי רכב שתואמים לאפשרויות הבקשה. |
|
כתיבת נתוני הרכב המעודכנים ב-Fleet Engine. |
|
עדכון חלקי של מאפייני הרכב. |