המוצר או התכונה האלה נמצאים בשלב השקה ניסיוני של טרום-GA (pre-GA). יכול להיות שהתמיכה במוצרים ובתכונות טרום-GA תהיה מוגבלת, ויכול להיות ששינויים במוצרים ובתכונות טרום-GA לא יהיו תואמים לגרסאות אחרות של טרום-GA. מוצרים במצב טרום-GA מכוסים במסגרת התנאים הספציפיים לשירות של הפלטפורמה של מפות Google. מידע נוסף זמין בתיאורים של שלבי ההשקה.

דף זה תורגם על ידי Cloud Translation API.

RouteModifiers (Automotive)

ייצוג JSON
VehicleInfo
- ייצוג JSON
VehicleEmissionType
TrailerInfo
- ייצוג JSON
TollPass
HOVPreference
- ייצוג JSON

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

ייצוג JSON

ייצוג JSON
{ "avoidTolls": boolean, "avoidHighways": boolean, "avoidFerries": boolean, "avoidIndoor": boolean, "vehicleInfo": { object (`VehicleInfo`) }, "tollPasses": [ enum (`TollPass`) ], "avoidTunnels": boolean, "avoidVignettes": [ string ], "hovPreference": { object (`HOVPreference`) } }

{
  "avoidTolls": boolean,
  "avoidHighways": boolean,
  "avoidFerries": boolean,
  "avoidIndoor": boolean,
  "vehicleInfo": {
    object (VehicleInfo)
  },
  "tollPasses": [
    enum (TollPass)
  ],
  "avoidTunnels": boolean,
  "avoidVignettes": [
    string
  ],
  "hovPreference": {
    object (HOVPreference)
  }
}

שדות
`avoidTolls`	`boolean` אם המדיניות מוגדרת כ-True, נמנעת מכבישי אגרה במקומות שבהם הסבירות היא סבירה, ותינתן עדיפות למסלולים שלא מכילים כבישי אגרה. רלוונטי רק ל`RouteTravelMode` של `TWO_WHEELER` ול`DRIVE`.
`avoidHighways`	`boolean` אם המדיניות מוגדרת כ-True, נמנעת מכבישים מהירים שבהם סבירה, ומעניקה עדיפות למסלולים שאינם מכילים כבישים מהירים. רלוונטי רק ל`RouteTravelMode` של `TWO_WHEELER` ול`DRIVE`.
`avoidFerries`	`boolean` אם המדיניות מוגדרת כ-True, נמנעת ממעבורות במקומות סבירים ומעניקה עדיפות למסלולים שלא מכילים מעבורות. חל רק על `DRIVE` ועל`TWO_WHEELER` `RouteTravelMode`.
`avoidIndoor`	`boolean` אם המדיניות מוגדרת כ-True, תימנע מניווט בתוך מבנים במקומות סבירים, תוך מתן עדיפות למסלולים שלא מכילים ניווט בתוך מבנים. רלוונטי רק ל`RouteTravelMode` של `WALK`.
`vehicleInfo`	`object (VehicleInfo)` מציין את פרטי הרכב.
`tollPasses[]`	`enum (TollPass)` כולל מידע על אישורי מעבר לכבישי אגרה. אם תספקו אישורי מעבר לכבישי אגרה, ה-API ינסה להחזיר את מחיר המינוי. אם לא תספקו אישורי מעבר לכבישי אגרה, ה-API יתייחס למינוי בתשלום בתור לא ידוע וינסה להחזיר את המחיר במזומן. רלוונטי רק ל`RouteTravelMode` של `TWO_WHEELER` ול`DRIVE`.
`avoidTunnels`	`boolean` אם המדיניות מוגדרת כ-True, המערכת מונעת מנהרות במקומות שבהם הסבירות היא סבירה, ומעניקה עדיפות למסלולים שלא מכילים מנהרות. רלוונטי רק ל`RouteTravelMode` של `TWO_WHEELER` ול`DRIVE`. הערך של `RoutingPreference` חייב להיות `TRAFFIC_AWARE_OPTIMAL`. השדה הזה לא נתמך בגרסה v2.computeRouteMatrix.
`avoidVignettes[]`	`string` אם המדיניות מוגדרת כ-True, המערכת תימנע מכבישים עם מודעות ביניים במדינות מסוימות שבהן יש סיכוי סביר, ותינתן עדיפות למסלולים שלא מכילים נסיעות בכבישים עם מודעות ביניים במדינות שמפורטות ברשימת המדינות שתומכות בתכונה הזו. רלוונטי רק ל`RouteTravelMode` של `TWO_WHEELER` ול`DRIVE`. הערך של `RoutingPreference` חייב להיות `TRAFFIC_AWARE_OPTIMAL`. יש לציין את המדינות בקודי האזורים לפי Unicode CLDR. המדינות הנתמכות הן CH, AT, CZ, HU, SI, SK. השדה הזה לא נתמך בגרסה v2.computeRouteMatrix.
`hovPreference`	`object (HOVPreference)` ההגדרה קובעת אם לשנות את המסלול בהתאם לנוכחות של כבישים שעומדים בדרישות של נתיבים לרכב רב-תפוסה. השדה הזה לא נתמך בגרסה v2.computeRouteMatrix.

VehicleInfo

מכילה את פרטי הרכב, כמו סוג הפליטה של הרכב.

ייצוג JSON

ייצוג JSON
{ "emissionType": enum (`VehicleEmissionType`), "totalAxleCount": integer, "totalHeightMm": string, "totalLengthMm": string, "totalWidthMm": string, "totalWeightKg": string, "trailerInfo": [ { object (`TrailerInfo`) } ] }

{
  "emissionType": enum (VehicleEmissionType),
  "totalAxleCount": integer,
  "totalHeightMm": string,
  "totalLengthMm": string,
  "totalWidthMm": string,
  "totalWeightKg": string,
  "trailerInfo": [
    {
      object (TrailerInfo)
    }
  ]
}

שדות
`emissionType`	`enum (VehicleEmissionType)` מתאר את סוג הפליטה של הרכב. רלוונטי רק ל`RouteTravelMode` של `DRIVE`.
`totalAxleCount`	`integer` המספר הכולל של סרנים. אם הפרמטר מוגדר, הערך חייב להיות >= 2. חובה להגדיר את ההפעלה של משאיות, אבל אופציונלי כשמדובר בנגרר. השדה הזה לא נתמך ב-v2.computeRouteMatrix כאשר `RouteTravelMode` הוא `DRIVE`.
`totalHeightMm`	`string (int64 format)` גובה הרכב, כולל הגובה של הנגררים המחוברים. צריך להגדיר את הטריגר למשאיות או לנגררים. השדה הזה לא נתמך ב-v2.computeRouteMatrix כאשר `RouteTravelMode` הוא `DRIVE`.
`totalLengthMm`	`string (int64 format)` אורך הרכב, כולל האורך של נגררים מחוברים. צריך להגדיר את הטריגר למשאיות או לנגררים. השדה הזה לא נתמך ב-v2.computeRouteMatrix כאשר `RouteTravelMode` הוא `DRIVE`.
`totalWidthMm`	`string (int64 format)` רוחב הרכב, כולל הרוחב של נגררים מחוברים. צריך להגדיר את הטריגר למשאיות או לנגררים. השדה הזה לא נתמך ב-v2.computeRouteMatrix כאשר `RouteTravelMode` הוא `DRIVE`.
`totalWeightKg`	`string (int64 format)` משקל הרכב, כולל משקלים של נגררים מחוברים. המשקל בהקשר הזה מתייחס למשקל בפועל, ולא לדירוג המשקל. צריך להגדיר את הטריגר למשאיות או לנגררים. השדה הזה לא נתמך ב-v2.computeRouteMatrix כאשר `RouteTravelMode` הוא `DRIVE`.
`trailerInfo[]`	`object (TrailerInfo)` מכילה רשומה אחת לכל טריילר. אם סופקו פרטי הטריילר, צריך להגדיר את `RoutingPreference` לערך `TRAFFIC_AWARE_OPTIMAL`. השדה הזה לא נתמך ב-v2.computeRouteMatrix כאשר `RouteTravelMode` הוא `DRIVE`.

VehicleEmissionType

קבוצת ערכים שמתארים את סוג הפליטה של הרכב. רלוונטי רק לRouteTravelMode של DRIVE.

טיפוסים בני מנייה (enums)
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	לא צוין סוג פליטה. ברירת המחדל היא `GASOLINE`.
`GASOLINE`	רכב עם מנוע בנזין/בנזין.
`ELECTRIC`	רכב שמופעל בחשמל.
`HYBRID`	דלק היברידי (למשל: בנזין + חשמלי).
`DIESEL`	רכב עם מנוע סולר.

TrailerInfo

מידע על נגררים נפרדים שמחוברים לרכב. להובלה של נגררים יש לספק אורך של נגרר. שאר המאפיינים הם אופציונליים. סך כל המאפיינים צריך לכלול את המאפיינים של כל טריילר. לדוגמה, totalHeightMm חייב תמיד להיות גדול מ-trailerInfo.height_mm או שווה לו.

ייצוג JSON
{ "heightMm": string, "lengthMm": string, "widthMm": string, "weightKg": string }

שדות
`heightMm`	`string (int64 format)` גובה הנגרר.
`lengthMm`	`string (int64 format)` אורך הטריילר.
`widthMm`	`string (int64 format)` רוחב הטריילר.
`weightKg`	`string (int64 format)` משקל הנגרר. המשקל בהקשר הזה מתייחס למשקל בפועל, ולא לדירוג המשקל.

TollPass

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

טיפוסים בני מנייה (enums)
`TOLL_PASS_UNSPECIFIED`	לא בשימוש. אם נעשה שימוש בערך הזה, הבקשה תיכשל.
`AU_ETOLL_TAG`	מינוי לכביש אגרה בסידני. פרטים נוספים זמינים בכתובת https://www.myetoll.com.au.
`AU_EWAY_TAG`	מינוי לכביש אגרה בסידני. פרטים נוספים זמינים בכתובת https://www.tollpay.com.au.
`AU_LINKT`	מינוי לכבישי אגרה ברחבי אוסטרליה. פרטים נוספים זמינים בכתובת https://www.linkt.com.au/.
`AR_TELEPASE`	מינוי לכביש אגרה בארגנטינה. פרטים נוספים זמינים בכתובת https://telepase.com.ar
`BR_AUTO_EXPRESO`	מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://www.autoexpreso.com
`BR_CONECTCAR`	מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://conectcar.com.
`BR_MOVE_MAIS`	מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://movemais.com.
`BR_PASSA_RAPIDO`	מינוי לכביש אגרה בברזיל. אפשר לקרוא פרטים נוספים בכתובת https://pasorapido.gob.do/
`BR_SEM_PARAR`	מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://www.semparar.com.br.
`BR_TAGGY`	מינוי לכביש אגרה בברזיל. פרטים נוספים זמינים בכתובת https://taggy.com.br.
`BR_VELOE`	מינוי לכביש אגרה בברזיל. מידע נוסף זמין בכתובת https://veloe.com.br/site/onde-usar.
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	מעבר גבול מקנדה לארה"ב.
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	מעבר גבול מקנדה לארה"ב.
`CA_US_BLUE_WATER_EDGE_PASS`	מעבר גבול בין ארצות הברית מאונטריו, קנדה למישיגן.
`CA_US_CONNEXION`	מעבר גבול בין ארצות הברית מאונטריו, קנדה למישיגן.
`CA_US_NEXUS_CARD`	מעבר גבול מקנדה לארה"ב.
`ID_E_TOLL`	אינדונזיה. כרטיס אלקטרוני שמסופק על ידי מספר בנקים ומשמש לתשלום על כבישי האגרה. כל הכרטיסים האלקטרונים שדרך הבנקים מחויבים באותו אופן, כך שיש צורך רק בערך אחד של טיפוסים בני מנייה (enum) אחד. לדוגמה: Bank Mandiri https://www.bankmandiri.co.id/e-money – BCA https://www.bca.co.id/flazz – BNI https://www.bni.co.id/id-id/ebanking/tapcash
`IN_FASTAG`	India.‎
`IN_LOCAL_HP_PLATE_EXEMPT`	הודו, פטור מהלוחית הרישוי של מדינת HP.
`JP_ETC`	Japan ETC. מערכת אלחוטית אלקטרונית לגביית כבישי אגרה. https://www.go-etc.jp/
`JP_ETC2`	Japan ETC2.0. גרסה חדשה של ETC עם הנחות נוספות ותקשורת דו-כיוונית בין מכשירים על כלי רכב ואנטנות בכביש. https://www.go-etc.jp/etc2/index.html
`MX_IAVE`	כרטיס אגרה במקסיקו. https://iave.capufe.gob.mx/#/
`MX_PASE`	מקסיקו https://www.pase.com.mx
`MX_QUICKPASS`	מקסיקו https://operadoravial.com/quick-pass/
`MX_SISTEMA_TELEPEAJE_CHIHUAHUA`	http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
`MX_TAG_IAVE`	מקסיקו
`MX_TAG_TELEVIA`	חברה לכרטיסי אגרה במקסיקו. אחד מתוך רבים שפועלים במקסיקו סיטי. פרטים נוספים זמינים בכתובת https://www.televia.com.mx.
`MX_TELEVIA`	חברה לכרטיסי אגרה במקסיקו. אחת מהסניפים הרבים שפועלים במקסיקו סיטי. https://www.televia.com.mx
`MX_VIAPASS`	מינוי לכביש אגרה במקסיקו. פרטים נוספים זמינים בכתובת https://www.viapass.com.mx/viapass/web_home.aspx.
`US_AL_FREEDOM_PASS`	אלבמה, ארה"ב.
`US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS`	AK, ארה"ב.
`US_CA_FASTRAK`	קנדה, ארה"ב.
`US_CA_FASTRAK_CAV_STICKER`	מציין שלנהג יש אישור FasTrak בנוסף לסטיקר CLV (רכב אוויר נקי (CAV)) שהונפק על ידי ה-DMV. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	CO, ארה"ב.
`US_CO_GO_PASS`	CO, ארה"ב.
`US_DE_EZPASSDE`	גרמניה, ארה"ב.
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	פלורידה, ארה"ב.
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	פלורידה, ארה"ב.
`US_FL_EPASS`	פלורידה, ארה"ב.
`US_FL_GIBA_TOLL_PASS`	פלורידה, ארה"ב.
`US_FL_LEEWAY`	פלורידה, ארה"ב.
`US_FL_SUNPASS`	פלורידה, ארה"ב.
`US_FL_SUNPASS_PRO`	פלורידה, ארה"ב.
`US_IL_EZPASSIL`	אילינוי, ארה"ב.
`US_IL_IPASS`	אילינוי, ארה"ב.
`US_IN_EZPASSIN`	הודו, ארה"ב.
`US_KS_BESTPASS_HORIZON`	קנזס, ארה"ב.
`US_KS_KTAG`	קנזס, ארה"ב.
`US_KS_NATIONALPASS`	קנזס, ארה"ב.
`US_KS_PREPASS_ELITEPASS`	קנזס, ארה"ב.
`US_KY_RIVERLINK`	KY, ארה"ב.
`US_LA_GEAUXPASS`	לואיזיאנה, ארה"ב.
`US_LA_TOLL_TAG`	לואיזיאנה, ארה"ב.
`US_MA_EZPASSMA`	מסצ'וסטס, ארה"ב.
`US_MD_EZPASSMD`	מרילנד, ארה"ב.
`US_ME_EZPASSME`	ME, ארה"ב.
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	מישיגן, ארה"ב.
`US_MI_BCPASS`	מישיגן, ארה"ב.
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	מישיגן, ארה"ב.
`US_MI_IQ_PROX_CARD`	מישיגן, ארה"ב. הוצא משימוש כי סוג הכרטיס הזה כבר לא קיים. הפריט הזה הוצא משימוש.
`US_MI_IQ_TAG`	מישיגן, ארה"ב.
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	מישיגן, ארה"ב.
`US_MI_NEXPRESS_TOLL`	מישיגן, ארה"ב.
`US_MN_EZPASSMN`	מינסוטה, ארה"ב.
`US_NC_EZPASSNC`	קרוליינה הצפונית, ארה"ב.
`US_NC_PEACH_PASS`	קרוליינה הצפונית, ארה"ב.
`US_NC_QUICK_PASS`	קרוליינה הצפונית, ארה"ב.
`US_NH_EZPASSNH`	NH, ארה"ב.
`US_NJ_DOWNBEACH_EXPRESS_PASS`	ניו ג'רזי, ארה"ב.
`US_NJ_EZPASSNJ`	ניו ג'רזי, ארה"ב.
`US_NY_EXPRESSPASS`	ניו יורק, ארה"ב.
`US_NY_EZPASSNY`	ניו יורק, ארה"ב.
`US_OH_EZPASSOH`	אוהיו, ארה"ב.
`US_PA_EZPASSPA`	PA, ארה"ב.
`US_RI_EZPASSRI`	RI, ארה"ב.
`US_SC_PALPASS`	קרוליינה הדרומית, ארה"ב.
`US_TX_AVI_TAG`	טקסס, ארה"ב.
`US_TX_BANCPASS`	טקסס, ארה"ב.
`US_TX_DEL_RIO_PASS`	טקסס, ארה"ב.
`US_TX_EFAST_PASS`	טקסס, ארה"ב.
`US_TX_EAGLE_PASS_EXPRESS_CARD`	טקסס, ארה"ב.
`US_TX_EPTOLL`	טקסס, ארה"ב.
`US_TX_EZ_CROSS`	טקסס, ארה"ב.
`US_TX_EZTAG`	טקסס, ארה"ב.
`US_TX_FUEGO_TAG`	טקסס, ארה"ב.
`US_TX_LAREDO_TRADE_TAG`	טקסס, ארה"ב.
`US_TX_PLUSPASS`	טקסס, ארה"ב.
`US_TX_TOLLTAG`	טקסס, ארה"ב.
`US_TX_TXTAG`	טקסס, ארה"ב.
`US_TX_XPRESS_CARD`	טקסס, ארה"ב.
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	יוטה, ארה"ב.
`US_VA_EZPASSVA`	וירג'יניה, ארה"ב.
`US_WA_BREEZEBY`	וושינגטון, ארה"ב.
`US_WA_GOOD_TO_GO`	וושינגטון, ארה"ב.
`US_WV_EZPASSWV`	WV, ארה"ב.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	WV, ארה"ב.
`US_WV_MOV_PASS`	WV, ארה"ב
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	WV, ארה"ב.

HOVPreference

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

ייצוג JSON
{ "allowHov": boolean }

שדות

שדות
`allowHov`	`boolean` ההגדרה קובעת אם לאפשר מסלול שעובר בכבישים שמאפשרים נסיעה של נתיבים לרכב רב-תפוסה, וגם בקטעים של נתיבים לרכב רב-תפוסה. כברירת מחדל, תינתן עדיפות למסלולים שלא מכילים דרכים לרכב רב-תפוסה בלבד. הערך של `RoutingPreference` חייב להיות `TRAFFIC_AWARE_OPTIMAL`.

allowHov

boolean

ההגדרה קובעת אם לאפשר מסלול שעובר בכבישים שמאפשרים נסיעה של נתיבים לרכב רב-תפוסה, וגם בקטעים של נתיבים לרכב רב-תפוסה. כברירת מחדל, תינתן עדיפות למסלולים שלא מכילים דרכים לרכב רב-תפוסה בלבד. הערך של RoutingPreference חייב להיות TRAFFIC_AWARE_OPTIMAL.