از نسخه پیش نمایش مهاجرت کنید
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
توسعه دهندگان منطقه اقتصادی اروپا (EEA). Routes API به‌عنوان پیش‌نمایش عمومی (قبل از GA) در سپتامبر 2022 منتشر شد. پیشنهادات Pre-GA تحت شرایط خاص سرویس پلتفرم Google Maps قرار دارند. برای اطلاعات بیشتر، به توضیحات مرحله راه اندازی مراجعه کنید.
این بخش نحوه انتقال یک برنامه از نسخه پیش نمایش به نسخه GA را توضیح می دهد.
ویژگی های جدید به نسخه GA اضافه شده است
نسخه GA ویژگی‌های جدید زیر را اضافه می‌کند که در پیش‌نمایش گنجانده نشده‌اند:
به همراه شناسه‌های مکان و مختصات طول و عرض جغرافیایی، اکنون می‌توانید با استفاده از:
رشته‌های آدرس ("Chicago, IL" یا "Darwin, NT, Australia")
رشته های آدرس اغلب نحوه وارد کردن یک آدرس توسط کاربر است. با این حال، {product_name} باید ابتدا رشته آدرس را به صورت داخلی جغرافیایی کند تا آن را به مختصات طول و عرض جغرافیایی تبدیل کند تا بتواند مسیری را محاسبه کند.
علاوه بر این، پشتیبانی از پارامتر درخواست regionCode اضافه شده است، که به شما امکان می دهد نتایج جغرافیایی کد شده را برای یک منطقه جغرافیایی خاص بازگردانید.
کدهای پلاس
کدهای پلاس مانند آدرس های خیابان افراد یا مکان هایی هستند که آدرس واقعی ندارند. به جای آدرس هایی با نام و شماره خیابان، کدهای پلاس بر اساس طول و عرض جغرافیایی هستند و به صورت اعداد و حروف نمایش داده می شوند.
پاسخ مسیرهای محاسبه اکنون حاوی آرایه geocodingResults است. برای هر مکان در درخواست (مبداء، مقصد، یا نقطه میانی) که به عنوان رشته آدرس یا کد پلاس مشخص شده است، API جستجوی شناسه مکان را انجام می دهد. هر عنصر این آرایه حاوی شناسه مکان مربوط به یک مکان به همراه ابرداده اضافی درباره مکان است. مکان های موجود در درخواست که به عنوان شناسه مکان یا مختصات طول و عرض جغرافیایی مشخص شده اند نادیده گرفته می شوند.
تغییرات در ویژگی های پیش نمایش موجود
اکنون باید با افزودن فیلد extraComputations آرایه جدید به درخواست، ویژگی های زیر را به صراحت در GA فعال کنید:
در نسخه پیش‌نمایش، از یک فیلد ماسک برای بازگرداندن اطلاعات مربوط به این ویژگی‌ها در پاسخ استفاده کردید. حال، شما باید هر دو:
- پارامتر درخواست آرایه
extraComputations جدید را برای فعال کردن این ویژگی ها تنظیم کنید. - یک فیلد ماسک را برای بازگرداندن اطلاعات در پاسخ تنظیم کنید.
چه چیزی باید بدانم؟
فیلدهای زیر دیگر در پاسخ‌های computeRouteMatrix گنجانده نمی‌شوند مگر اینکه به‌صراحت با تنظیم extraComputations فعال شوند:
-
travelAdvisory.tollInfo (اطلاعات عوارض)
فیلدهای زیر دیگر در پاسخ‌های computeRoutes گنجانده نمی‌شوند مگر اینکه به‌صراحت با تنظیم extraComputations فعال شوند:
-
routes.legs.travelAdvisory.tollInfo (اطلاعات عوارض) -
routes.travelAdvisory.tollInfo (اطلاعات عوارض) -
routes.travelAdvisory.fuelConsumptionMicroliters (مصرف سوخت) -
routes.travelAdvisory.speedReadingIntervals (ترافیک روی چند خط) -
routes.legs.travelAdvisory.speedReadingIntervals (ترافیک روی چند خط)
چه کاری باید انجام دهم؟
برای دریافت فیلدهای پاسخ برای اطلاعات عوارض، مصرف سوخت، یا ترافیک روی چند خط، باید فیلد آرایه درخواست جدید extraComputations را طوری تنظیم کنید که شامل یک یا چند مقدار زیر باشد:
برای دریافت اطلاعات عوارض ، فیلد جدید آرایه extraComputations را روی "TOLLS" تنظیم کنید.
برای دریافت مصرف سوخت ، فیلد جدید آرایه extraComputations را روی "FUEL_CONSUMPTION" تنظیم کنید.
برای دریافت اطلاعات ترافیک در چند خط ، فیلد آرایه extraComputations جدید را روی "TRAFFIC_ON_POLYLINE" تنظیم کنید.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده Oracle و/یا شرکتهای وابسته به آن است.
تاریخ آخرین بهروزرسانی 2025-07-22 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-07-22 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eThe Routes API has transitioned from Preview to General Availability (GA), introducing new features and changes to existing ones.\u003c/p\u003e\n"],["\u003cp\u003eYou can now specify locations using address strings and Plus Codes in addition to place IDs and coordinates.\u003c/p\u003e\n"],["\u003cp\u003eToll info, fuel consumption, and traffic on a polyline now require explicit enablement using the \u003ccode\u003eextraComputations\u003c/code\u003e field in requests.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003egeocodingResults\u003c/code\u003e array has been added to the response, providing place IDs and metadata for locations specified as address strings or Plus Codes.\u003c/p\u003e\n"],["\u003cp\u003eExisting implementations relying on implicit inclusion of toll info, fuel consumption, or traffic on a polyline data need to be updated to utilize the \u003ccode\u003eextraComputations\u003c/code\u003e field.\u003c/p\u003e\n"]]],["The Routes API's GA release introduces new location specification options, including address strings and Plus Codes, and includes a `geocodingResults` array in the response. To enable toll info, fuel consumption, and traffic on a polyline, users must now set the `extraComputations` array in their requests. `extraComputations` values are \"TOLLS\", \"FUEL_CONSUMPTION\", and \"TRAFFIC_ON_POLYLINE\". The field mask must still be used. Certain fields will be omitted in the response unless enabled by `extraComputations`.\n"],null,["# Migrate from the Preview release\n\n**European Economic Area (EEA) developers** If your billing address is in the European Economic Area, effective on 8 July 2025, the [Google Maps Platform EEA Terms of Service](https://cloud.google.com/terms/maps-platform/eea) will apply to your use of the Services. Functionality varies by region. [Learn more](/maps/comms/eea/faq).\n\nThe Routes API was released as a public Preview (pre-GA) in September of\n2022. Pre-GA Offerings are covered by the [Google Maps Platform Service Specific\nTerms](https://cloud.google.com/maps-platform/terms/maps-service-terms).\nFor more information, see the [launch stage descriptions](/maps/launch-stages).\n\nThis section describes how to migrate an app from the Preview release to the GA\nrelease.\n\nNew features added to the GA release\n------------------------------------\n\nThe GA release adds the following new features that were not included in the\nPreview:\n\n- Along with place IDs and latitude/longitude coordinates, you can now\n [specify a location](/maps/documentation/routes/specify_location) in the GA release by using:\n\n - [Address strings](/maps/documentation/routes/specify_location#text_string) (\"Chicago, IL\" or\n \"Darwin, NT, Australia\")\n\n Address strings are often how a user inputs an address. However,\n {product_name} must first geocode the address string internally to convert\n it to latitude/longitude coordinates before it can calculate a route.\n\n In addition, support for the `regionCode` request parameter has been\n added, which lets you specify to return geocoded results for a specific\n geographic region.\n - [Plus Codes](/maps/documentation/routes/specify_location#plus_code)\n\n Plus Codes are like street addresses for people or places that don't\n have an actual address. Instead of addresses with street names and\n numbers, Plus Codes are based on latitude and longitude, and are\n displayed as numbers and letters.\n- The [compute routes response](/maps/documentation/routes/understand-route-response) now contains the\n `geocodingResults` array. For every location in the request (origin,\n destination, or intermediate waypoint) that was specified as an **address\n string** or as a **Plus code**, the API performs a place ID lookup. Each\n element of this array contains the place ID corresponding to a location\n along with additional metadata about the location. Locations in the request\n specified as a place ID or as latitude/longiiture coordinates are ignored.\n\nChanges to existing Preview features\n------------------------------------\n\nYou must now explicitly enable the following features in the GA by\nadding the new array `extraComputations` field to the request:\n\n- [Toll info](/maps/documentation/routes/calculate_toll_fees)\n\n- [Fuel consumption](/maps/documentation/routes/eco-routes)\n\n- [Traffic on a polyline](/maps/documentation/routes/traffic_on_polylines)\n\nIn the Preview release, you used a [field mask](/maps/documentation/routes/choose_fields) to specify to\nreturn information for these features in the response. Now, you must both:\n\n- Set the new `extraComputations` array request parameter to enable these features.\n- Set a field mask to specify to return the information in the response.\n\n### What do I need to know?\n\nThe following fields will no longer be included in\n[computeRouteMatrix responses](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRouteMatrix#response-body)\nunless explicitly enabled by setting `extraComputations`:\n\n- `travelAdvisory.tollInfo` (Toll info)\n\nThe following fields will no longer be included in\n[computeRoutes responses](/maps/documentation/routes/reference/rest/v2/TopLevel/computeRoutes#response-body)\nunless explicitly enabled by setting `extraComputations`:\n\n- `routes.legs.travelAdvisory.tollInfo`(Toll info)\n- `routes.travelAdvisory.tollInfo`(Toll info)\n- `routes.travelAdvisory.fuelConsumptionMicroliters`(Fuel consumption)\n- `routes.travelAdvisory.speedReadingIntervals`(Traffic on a polyline)\n- `routes.legs.travelAdvisory.speedReadingIntervals`(Traffic on a polyline)\n\n### What do I need to do?\n\nTo receive the response fields for toll info, fuel consumption, or traffic on a\npolyline, you must set the new request array field, `extraComputations`, to\ninclude one or more of the following values:\n\n- To receive [toll info](/maps/documentation/routes/calculate_toll_fees), set the new\n `extraComputations` array field to `\"TOLLS\"`.\n\n- To receive [fuel consumption](/maps/documentation/routes/eco-routes), set the new `extraComputations`\n array field to `\"FUEL_CONSUMPTION\"`.\n\n- To receive [traffic information on polylines](/maps/documentation/routes/traffic_on_polylines), set the\n new `extraComputations` array field to `\"TRAFFIC_ON_POLYLINE\"`."]]
