RESTful APIs

Location, Routing & Mapping Release Notes

Contents

May 24, 2023

May 18, 2023

  • IMPROVED A new response field in the Reverse Geocoding API , TimeZoneOffset, displays a location’s time zone as an offset to Greenwich Mean Time (GMT). The format is “GMT{offset}.” For example, “GMT-5:00” for Eastern Standard Time in North America or “GMT+1:00” for the Western European Time Zone.

  • IMPROVED Batch POST Route Reports now display an error message when one of the routes cannot be calculated.

  • IMPROVED Routing APIs now return full postal codes for customers licensed for that data in select parts of Europe.

  • FIXED Fixed an error where Summer Time in Europe was being reported in Route Reports during the wrong time of year.

April 13, 2023

April 4, 2023

  • FIXED Removed an incorrect error message in Route Reports that indicated only live traffic is available outside of North America for versions 29 and higher. Both live and historical traffic patterns may be used in calculations, depending on the departure time.

March 28, 2023

March 13, 2023

Feb. 16, 2023

Feb. 14, 2023

  • IMPROVED Enhanced the routing algorithm so it will always take into account road closures with an indefinite end date.

  • IMPROVED Added an error message in batch POST Route Reports if a route fails to calculate.

  • FIXED Fixed an issue preventing Route Modifiers (roads to avoid or favor) from consistently being applied to Routing API calls.

  • FIXED Fixed the RemovedStops field that is returned by the Time Window Routing API to ensure it returns all removed stops, including duplicate stops, and has the correct format for stop coordinates.

  • FIXED Fixed an issue that would cause the routing algorithm to ignore an Entry/Exit Path into a Site if the path included a road designated as “No Thru Trucks.”

  • FIXED Fixed an issue where the Geocoding API failed to return a full address in the Netherlands when a full postcode was included in the request.

Feb. 8, 2023

Jan. 19, 2023

  • IMPROVED Updated map data in Europe.

Jan. 4, 2023

  • IMPROVED Improved results returned by the Single Search Geocoding API for queries that include both a fielded POI name and a street address without fields.

Dec. 14, 2023

Nov. 30, 2022

  • IMPROVEDThe following updates were made to the Single Search Geocoding API :
    • Enhanced data for Mexico is now available for customers licensed for Worldwide (WW) data. It can be called using the WW or Mexico (MX) endpoints.
    • More requests now return a TrimblePlaceId by default if the location in the query matches a location in the Trimble Maps Places library .

Nov. 16, 2022

  • IMPROVED The Routing APIs now incorporate state-specific exemptions to the State and National Network when routing 53-foot trailers in the U.S.. In states where exemptions to State and National Network designated highways are in place, the APIs generate a more practical route with increased freedom to travel off the network.

  • IMPROVED Improved the ability of the routing algorithm to avoid closed roads in routes. This includes time-based closures, and roads effectively “closed” by user settings including vehicle type, hazmat settings, and elevation limits.

  • IMPROVED Vehicle Routing Profiles created in FleetPortal can now be used in the Routing APIs. Enter the name of the profile in the profileName parameter.

  • IMPROVED Improved the posted road speed limits returned by the Reverse Geocoding API .

  • IMPROVED Updated map data in Asia.

  • FIXED The elevLimit parameter is now ignored if set to 0 in Routing APIs.

Nov. 3, 2022

Oct. 19, 2022

Oct. 13, 2022

Sept. 22, 2022

  • IMPROVEDThe following updates were made to the Single Search Geocoding API :
    • Updated data in North America , South America, Africa and Oceania.
    • Improved the handing of addresses that use the single quotation mark.
    • Improved results when the currentLonLat parameter is added to a query.
    • Improved results returned when a user enters a partial ZIP code.

Sept. 15, 2022

  • NEW The Routing APIs now support routing for RVs (also called caravans in some regions) based on the default dimensions in these charts . To calculate an RV route, set the profileName to RV. This setting is not compatible with older versions of PC*MILER so dataVersion must be Current, which is the default setting.

  • IMPROVED Hours of Service (HOS) calculations in Routing APIs were enhanced to improve ETA accuracy and help eliminate “rest stop insertion failed” errors. Improvements include:

    • Better accounting for consecutive off duty time and cycle time gains during a weekly cycle.
    • Proper switching from Driver 1 to Driver 2 in team driving situations.

  • IMPROVED A RoutePath report can now be returned when calling a Derived Route report using the POST method. A derived route is the estimated route a vehicle took based on a series of latitude/longitude pings. The route path is the series of geographic coordinates that make up that estimated route.

  • FIXED Fixed the eventNames filter in the Weather Alerts report .

  • FIXED Fixed versions PCM26 and PCM27 so that POST route reports recognize the parameter names Lat and Lon when both coordinates and an address are passed in.

  • FIXED Fixed an issue that could cause inaccurate ETAs when TimeZone is set to UTC or GMT.

  • FIXED Fixed an issue that could cause the routing algorithm to avoid using one-way roads, even when trucks are permitted.

Sept. 8, 2022

June 29, 2022

  • NEW PC*MILER 36 Version Release. With each new version, PC*MILER’s routing algorithm and map data are enhanced to generate the best routes and the most accurate travel times and distances for your vehicles. Improvements since version 35 include:
    • New Roads. 427 new construction road projects were added to the road network.
    • Updated clearances. Vertical clearances were updated in: Arkansas, Hawaii, Manitoba, Massachusetts, Nebraska, New Jersey, Pennsylvania, South Carolina, Wisconsin
    • Updated weight limits. Weight limits were updated in: Alaska, Alberta, British California, Columbia, Colorado, Connecticut, Delaware, District of Columbia, Florida, Georgia, Hawaii, Idaho, Illinois, Indiana, Iowa, Kansas, Kentucky, Manitoba, Massachusetts, Missouri, Montana, Nebraska, Nevada, New Brunswick, Newfoundland and Labrador, New Mexico, North Carolina, Nova Scotia, Ohio, Oregon, Pennsylvania, Prince Edward Island, Rhode Island, South Carolina, Saskatchewan, South Dakota, Tennessee, Virginia, Washington, West Virginia, Wisconsin, Wyoming, Yukon
    • 53’ Routing The 53’ Routing attribution was reviewed and updated in: Alabama, Alaska, Arkansas, Arizona, Colorado, Connecticut, Florida, Georgia, Hawaii, Illinois, Indiana, Iowa, Kansas, Kentucky, Louisiana, Maine, Manitoba, Maryland, Massachusetts, Michigan, Minnesota, Mississippi, Montana, Nebraska, Nevada, New Hampshire, New Jersey, New Mexico, New York, North Carolina, North Dakota, Ohio, Oklahoma, Oregon, Rhode Island, Saskatchewan, South Carolina, South Dakota, Tennessee, Texas, Utah, Vermont, Virginia, Washington, West Virginia, Wisconsin, Wyoming
    • New Places Nearly 100,000 Places with Sites were added to the Places database.
    • Route Costs Default route costs were updated to better reflect current labor and fuel costs.

Read more about PC*MILER version releases.

April 12, 2022

  • IMPROVEDThe following updates were made to the Single Search Geocoding API:
    • Updated to Q1.2 data in North America .
    • Reduced the number of secondary location matches returned when a high confidence match is found.
    • Added codes to error codes in Single Search Batch.

April 7, 2022

  • NEW The Routing APIs now support a wide range of preset vehicle routing profiles for regions throughout the world. A vehicle routing profile is a collection of settings that ensure the routing algorithm knows the type of vehicle being driven so it can generate a safe, efficient, and legal route. Preset profiles are named collections of default settings based on the industry standard types of commercial vehicles in regions around the world. These profiles:

    • Are thoroughly tested with Trimble Maps data. To pick the correct profile, you only have to match the profile’s dimensions to your vehicle’s dimensions.
    • Match the profiles available in other Trimble Maps applications, including CoPilot. This helps ensure you calculate the same routes across products.

Profiles are selected in API calls by entering the name of the profile in a new parameter, profileName. Read more about selecting a profile.

  • IMPROVED The number of languages that can be used in APIs has been expanded. See list

  • IMPROVED Improved the following in the Location APIs:

    • Matching of three-digit ZIP codes.
    • Better handling of the Canada Post abbreviation “siderd” for the road type Sideroad.
    • Better handling of the abbreviation “rd” for road.

  • FIXED Fixed an issue that could cause country codes to be returned in FIPS format when ISO3 is specified.

  • FIXED Fixed an issue that could cause routing calls to fail if the country is specified as “MX” instead of “Mexico.”

  • FIXED Fixed the Hours of Service (HOS) report to correctly identify border crossings as stop “Type”: 15.

April 6, 2022

  • NEW A new Multi-Vehicle Route Optimization API has been added to the RESTful APIs. Orders, vehicle information, and driver information can be sent into the service and the algorithm determines the number of routes needed for that given data, and what those routes will consist of (including the sequence of stops). The service returns a routed solution, including arrival/departure times, as well as solution statistics including total mileage, cost, hours, and violations. The API uses the same routing algorithm as Appian DRTrack and DirectRoute. Contact us to learn more about this service and the licensing required to use it.

March 22, 2022

  • NEW The Single Search Geocoding API now includes a batch endpoint that allows you to submit up to 50,000 location queries in a single request.

March 14, 2022

  • IMPROVED The library of places in North America that can be called using the Places API has been greatly expanded to include over 4 million Places and 2 million Sites.

    • A Place is collection of data about a location that is critical to the transportation industry—from distribution centers and loading docks to retail storefronts and rest stops. Places are useful for any application that requires precise information about a location , such as its address, GPS coordinates, operating hours, and more.

    • A Site is a polygonal geofence around the perimeter of a place. Many Sites have truck entrance and exit gates, which are essential for creating routes that direct drivers to exactly where they need to go. Sites that don’t include gates are useful for things such as visibility/tracking, arrival and departure notifications, and dwell time.

Learn more about how to retrieve Places and use them in the APIs.

Feb. 24, 2022

Feb. 8, 2022

Jan. 27, 2022

  • IMPROVED The following updates were made to the Single Search Geocoding service:

    • Improved matching for custom places and places defined in the Trimble Maps database.
    • Fixed an issue that could prevent search from considering all of the best possible matching locations when maxResults is set to 1.

Jan. 20, 2022

Jan. 12, 2022

  • NEW The Routing APIs now take into account the London Lorry Control Scheme when generating routes. The scheme restricts the movement of heavy goods vehicles (HGV) over 18 tons maximum gross weight at night and on weekends on specific roads in London.

  • IMPROVED The Routing APIs can now be set to Warn when a route passes through a Congestion Zone, a Low Emission Zone, or an Ultra Low Emission Zone in Europe.

  • IMPROVED Toll reports in Europe now better take into account the date and time of the trip when generating toll costs.

  • IMPROVED The maximum weight per axle group can now be set in Routing API calls:

    • In GET method calls, it can be set using a new parameter, trkMaxWeightPerAxleGroup.
    • In POST method calls, it can be set as part of the truckCfg object, using the new parameter MaxWeightPerAxleGroup.

  • IMPROVED The POI Radius Search API can now be set to limit Zip searches to a specific country.

  • IMPROVED The Route Matrix API can now take into account historical traffic data and avoids and favors when it calculates distances and travel times.

  • FIXED The following bug fixes are included in this release:

    • Fixed an issue preventing the setting of a departure or an arrival time when Coordinated Universal Time (UTC) is set as the time zone.
    • Fixed an issue that could cause incorrect geocoding when a coordinate is entered as a whole number.
    • Fixed an issue preventing ETA from being returned for trips in Newfoundland, Canada.
    • Fixed an issue that could cause the Time Window Routing API to return incorrect labels and OriginalPosition values when FinalStopIsEndDepot is set to false.

Jan. 6, 2022

Dec. 16, 2021

  • IMPROVED The following updates were made to the Single Search Geocoding service:

    • Improved the handling of queries with the abbreviation of “corp” for “corporation.”
    • Improved results returned for streets where each side of the street has a different ZIP code.

Nov. 19, 2021

  • IMPROVED The single search geocoding service can now return results from ZIP codes that only apply to post office boxes. To include P.O. boxes in results, the values POBox and Zip must be included in the includeOnly field when making your request. (North America only)

Oct. 21, 2021

  • IMPROVED Updated to Q3.2 data in North America .
  • IMPROVED Updated tolls data in Europe.
  • FIXED Fixed an issue preventing standard-level users from generating routes to locations in Nuevo Leon, Mexico.

Oct. 14, 2021

Aug. 26, 2021

  • IMPROVED Updated to Q3.1 data in North America
  • IMPROVED Updated tolls data in Europe.
  • FIXED Added support for “NX” and “NL” as valid state codes for Nuevo Leon in Mexico.

Aug. 12, 2021

  • IMPROVED Updated to Q3 data in North America.
  • IMPROVED Updated tolls data in Europe.

Aug. 11, 2021

  • IMPROVED The following updates were made to the Single Search Geocoding service:

    • Location matching for numbered state roads has been improved.
    • Address matching for reverse geocodes has also been improved.

Aug. 2, 2021

  • IMPROVED The logic used to insert Hours of Service (HOS) rest stops in a route has been enhanced to better maximize drive time. Rest stops will now be inserted closer to the time when an HOS violation would occur if a rest stop were not taken. Three new settings are available in HOS reports to customize when and how rest stops are inserted:
    • POIStopsReturned - Sets whether rest stops are returned as actual stop locations (POIs) along the route or only as the latitude/longitude coordinates for where the rest stop should be taken to avoid an HOS violation.
    • HOSWindowStart- Sets the time in minutes prior to when an HOS break is required that the algorithm should start looking for a rest stop to insert in the trip.
    • HOSWindowEnd - Sets the time in minutes prior to when an HOS break is required that the algorithm should finish looking for a rest stop to insert in the trip.

July 22, 2021

  • IMPROVED Updated to 2021 Q2 data in Europe.
  • IMPROVED Updated the energy data set in North America.
  • IMPROVED Updated to 2021 Q1 data in Asia.

July 12, 2021

July 8, 2021

  • NEW PC*MILER 35 Version Release. With each new version, PC*MILER’s routing algorithm and map data are enhanced to generate the best routes and the most accurate travel times and distances for your vehicles. This year’s improvements include:

    • Road speeds. Default road speeds have been improved to provide better estimated travel times.
    • Routing on major roads. The routing algorithm has been improved to avoid generating routes that leave a major road only to later return to it.
    • Turns on multi-road intersections. The routing algorithm can also better handle turns at complex intersections of multiple roads.
    • Routing to Sites . When Sites routing is turned on, the Site information is better incorporated into the route.
    • Metric precision. For improved accuracy, raw road data is now stored in metric units in countries that use the metric system. This avoids the need for conversions from imperial units.
    • Side of Street Adherence . The side of street logic was updated so it can be set for an entire trip or individually for each stop in a trip.
    • Speed Limits . Improved the logic used to determine the correct speed limit for a section of a road.
    • Updated toll data. Toll data was updated in the following U.S. states and Canadian provinces: California, Colorado, Florida, Illinois, Indiana, Maryland, Michigan, New Jersey, New York, North Carolina, Northwest Territories, Ohio, Oklahoma, Oregon, Pennsylvania, Quebec, Rhode Island, Texas, Vermont, Virginia
    • Street-level map data was updated, including weight limits, vertical clearances and truck through-travel restrictions.
    • Newly constructed roads and exit interchanges were added to the map data.
    • New Trimble Maps Verified Places with Sites were added to the map data.

  • IMPROVED The logic used in Hours of Service (HOS) calculations now supports 2020 Federal Motor Carrier Safety updates. That includes:

    • The adverse driving conditions exception, which expands the driving window during adverse driving conditions by up to an additional 2 hours.
    • The expansion of the short-haul exception to 150 air-miles.
    • Changes in the 30-minute break requirement to allow an on-duty/not driving period to qualify as the required break.

  • NEW A new Route Reports endpoint, /pcmversion , allows you to call a list of all of the currently available versions of PC*MILER.

  • IMPROVED Geocoding results have been improved, including cases where a portion of the search terms are invalid or unrelated to the actual address (such as a description of the location, for example).

  • IMPROVED The ConventionalSchoolBus and SmallSchoolBus vehicle routing profiles have been enhanced to better take into account the length of the bus when the route is generated.

  • NEW (Europe Only) You can now set whether routes generated by the Routing APIs should pass through Congestion and Environmental zones. Three settings are available: Avoid, Allow, or Warn when a route passes through a zone.

  • FIXED Bug fixes in this release include:

    • Fixed an issue that could cause incorrect Hours of Service (HOS) calculations for a trip originating in Canada and ending in the U.S.
    • Fixed HOS reports to properly recognize and incorporate CurrentOffDutyTimeDriver2 into trips with team drivers.
    • Fixed an issue that could allow locations to be returned for deprecated postal codes.

May 13, 2021

  • IMPROVED Updated to 2021 Q1 map data in Oceania and Africa

  • IMPROVED Updated toll data in Europe

April 1, 2021

March 31, 2021

March 25, 2021

  • NEW New parameters were added to the Hours of Service (HOS) Report that allow you to specify how much break time a driver has already accumulated during a trip. These new settings can improve estimated arrival and departure times for stops throughout the trip. The settings are:

    • CurrentOffDutyTime, which is how much off-duty time the driver has already accumulated during the trip at the time the HOS report request is made. This value is used to offset the length of an upcoming rest break. For example, if a driver is due for an end-of-day break, which is typically 10 hours, HOS logic will reduce that break duration by the amount of time entered in the CurrentOffDutyTime parameter. The format is in seconds.

    • CurrentOffDutyTimeDriver2, which is the same parameter but for team driving.

  • IMPROVED Increased coverage of Postal Codes in Europe.

  • IMPROVED Updated toll data in Europe.

March 3, 2021

  • IMPROVED The Single Search Geocoding service now uses point addressing when trying to obtain an address via reverse geocoding. Point addressing assigns GPS coordinates to each street address to improve accuracy.

Feb. 18, 2021

  • IMPROVED Updated to 2020 Q4 data in Europe.

Feb. 3, 2021

  • FIXED The following bug fixes were made to the Single Search Geocoding service:

    • Fixed incorrect results from a state abbreviation query for “MA” (Massachusetts) and “MD” (Maryland).
    • Fixed incorrect geocoding of “Via della resistenza” in the town of Sternatia, Italy.

Dec. 14, 2020

  • IMPROVED The sideOfStreetAdherence parameter in Routing APIs has been updated so if it is set to “Off” for an individual stop, that stop setting will override any global side-of-street setting for the entire trip.

  • IMPROVED The Reverse Geocoding API’s units parameter can now be set to “2” - Regional to automatically return posted road speed limits in MPH or KPH depending on the country of the geocoded location.

  • IMPROVED A new parameter, IncludeRoadClass, can be added to POST calls for Route Reports . If set to true, the road class will be returned in Detailed and Directions reports.

  • IMPROVED A new parameter, useCrossStreetTurnAvoidance, has been added to the route options for Routing APIs . When set to true, it reduces the chances the route generated includes turns that go across the street in front of oncoming traffic. These turns will still be included if there is no reasonable alternative. (For auto and van Vehicle Routing Profiles only)

  • IMPROVED A new parameter in the Time Window Routing API , ApplyStopLocalTimeZones, can be set to “False” if you would like to force all time windows to behave as if they were in the same time zone. By default, the Time Window Routing API automatically adjusts time windows, ETAs and ETDs to account for a stop’s local time zone.

  • IMPROVED Multiple geocoding improvements were made for individual locations in North America and Europe.

  • FIXED Fixed an issue that could cause a route to be run when the lon/lat for a stop was incorrectly placed over a body of water.

  • FIXED Fixed an issue that could cause routes generated in Sweden to include ferry mileage when the ferryDiscourage parameter is set to true.

  • FIXED Fixed the translation of warnings in reports.

  • FIXED Fixed the Time Window Routing API so that the HighwayOnly parameter is always set to false.

Dec. 1, 2020

  • IMPROVED The following enhancements were made to the Single Search Geocoding service:

    • You can now search for nearby POIs without a query text string. For example: https://singlesearch.alk.com/na/api/search?currentLonlat=-74.678362,40.288822&poiCategories=Hotel+or+Motel would search for hotels and motels near those GPS coordinates.

    • Improved handling of searches that include misspelled words

    • Updated to 2020 Q3 data in Europe

    • Updated to PC*MILER 34 Worldwide data

Nov. 5, 2020

  • IMPROVED Multiple improvements have been made to the speed limit data returned by the Reverse Geocoding API . (Requires Posted Speed Limit Add-on License) They include:

    • Updates of Trimble Maps link-based road speeds in North America
    • Updates of road speed data provided by HERE in North America and Europe
    • Improved accuracy and deprecated unnecessary parameters

  • IMPROVED Improved caching of Avoid/Favor sets for faster response times.

  • IMPROVED Improved the ability of our Routing APIs to dynamically select the active HOS rule (U.S. or Canada) based on the location of stops.

Oct. 21, 2020

The following updates were made to the Single Search Geocoding API :

  • NEW More than 104 million point addresses have been added to the Single Search map data in the United States. Point addressing assigns GPS coordinates to each street address, which can improve routing accuracy in both densely populated areas and rural areas where addresses are unevenly spread out along a road.

  • IMPROVED Updated to 2020 Q3.1 data in North America.

Oct. 20, 2020

  • IMPROVED Updated to PC*MILER 34 Worldwide data

  • FIXED Fixed Hours of Service (HOS) time tracking to include rest stop dwell time in our calculations when a user inputs their own stop with off-duty time.

  • FIXED Fixed an issue that could cause an invalid time at the first stop (the route’s origin) when the departure time was set to within 15 minutes of the current Eastern Standard Time in our Routing APIs.

Oct. 1, 2020

  • IMPROVED The weather radar coverage area for our JavaScript maps and Mapping APIs has been expanded to show more detail in regions throughout the world.

Sept. 24, 2020

  • IMPROVED The number of stops that can be entered and optimized using our Time Window Routing API has been increased to 500.

  • IMPROVED Our Derived Route API can now take into account map edits from MapExact , a licensed web tool that allows you to make custom edits to our map data to suit your company’s needs.

  • FIXED Fixed an issue that could cause our Routing APIs to fail when requesting Hours of Service rest stops on routes along the border of Mexico.

June 25, 2020

  • NEW Our annual version release incorporates the latest map data as well as routing, location and mapping API enhancements that have been made throughout the year. Highlights for version 34 of PC*MILER Web Services, include:

    • Better handling of “no through traffic” roads to prevent a circuitous route to reach a destination, while also avoiding these roads as a cut through.
    • A new sub-local road class in the map data for parking lot roads, park roads, alleyways, etc. Routing onto these roads is restricted, which prevents PC*MILER from using these roads as a cut through.
    • Updated commercial vehicle specific data, including:
      • Improved street-level map data, including weight limits, vertical clearances and truck through-travel restrictions. - Newly constructed roads and exit interchanges.
      • Improved city and ZIP/Postal Code placement and alignment.
      • Improved geocoding to better match an address to its actual “ground truth” latitude/longitude point.
      • Reducing the number of duplicate addresses.
      • Thousands of customer-recommended map improvements submitted via MapSure, our easy-to-use, online map reporting tool—directly into map data.
      • Updated toll data in California, Colorado, Florida, Georgia, Illinois, Indiana, Kentucky, Maryland, New Hampshire, New Jersey, North Carolina, Ohio, Ontario, Oregon, Pennsylvania, Prince Edward Island, Quebec, Rhode Island, South Carolina, Texas, Vermont, Virginia, Washington.
      • Improved road speed data used to calculate ETA and ETT in Montana.

  • IMPROVED PC*MILER 34 includes access to data about tens of thousands of additional commercial locations across North America that serve the transportation industry. Called “Places,” these locations range from distribution centers and manufacturing facilities to truck stops and Walmart locations with overnight parking. Places help you visualize an entire site on the map, such as a manufacturing plant, and they include additional details such as specific truck entrances and exits for more precise last-mile routing. Details about Places can be called using our Places API .

  • NEW A PlaceId can be entered as a stop in our Route Path and Route Reports APIs. If PlaceId is included, other location attributes included in the request are ignored, including an address or coordinates. The PlaceId for a location can be retrieved using our Places API .

  • NEW An ID can now be included for each stop in our Route Reports and RouteSync APIs.

  • NEW Two new toll discount programs, EZPass-MD and EZPass-ME, have been added to PC*MILER for use in toll cost calculation.

June 16, 2020

  • IMPROVED The following enhancements were made to our Single Search Geocoding service:
    • Updated to 2020 Q1 data in Europe.
    • Added Truck Stop as a filter in poiCategories.
    • Improved handling of missing spaces within a search query.

June 5, 2020

  • NEW A Route Path Report has been added to our Route Reports API. The report retrieves a series of geographic coordinates that make up a route. To call this report, you must be licensed to use our JavaScript Maps.

June 4, 2020

  • NEW A new parameter, FinalStopIsEndDepot, was added to our Time Window Routing API. It allows you to choose whether the final stop in the time window stop list should be treated as a fixed end depot or as another delivery stop.

June 1, 2020

May 27, 2020

  • NEW Our Places API can now retrieve Facility Information , if it is available for a given location. This information includes things such as the Place’s fuel options, parking information, amenities, and repair services.

May 20, 2020

  • NEW New parameters were added to our Routing and Mapping APIs that allow you to:

    • Choose whether toll roads should be avoided when generating a route. Options for the new tollRoads parameter include use, avoid if possible, and always avoid.

    • Apply multiple hazmat types and tunnel categories (Europe only) when generating a route. The new hazMatTypes parameter can accept an array of hazmat values , and tunnelCategories can accept an array of tunnel categories.

    • Choose to avoid or favor specific states or countries when generating a route. The new parameters are: avoidCountry, avoidState, favorCountry, and favorState.

    • Pass in an ID to uniquely identify assets in each routing call using a new assetId parameter.

  • NEW If a stop’s coordinates fall within a location that is part of the Trimble Maps Places database , and that Place includes hours of operation, Route Reports now return a warning if the ETA for reaching that location is outside of its operating hours.

  • IMPROVED The POIs Along the Route API now excludes POIs that are closed due to COVID-19.

  • IMPROVED The Time Window Routing API now better organizes twin stops in a more logical order. Twin stops are two or more stops with the same exact lat/long but different house or apartment numbers.

  • IMPROVED The emiType parameter used in Toll Detail Reports in Europe supports two additional emissions types: EURO 0 and EURO EEV.

  • IMPROVED A SideOfStreetAdherence level can now be added to each Stop object (StopLocation) in POST or SOAP requests to the Route Path, Route Reports and RouteSync APIs.

  • IMPROVED Geocoding was improved to find better matches for roads with fractional number names (i.e. Road 13.5 NW), road links with no postal code, and batch geocodes.

  • FIXED Fixed an issue that could cause an incorrect geocoding result when a ZIP code is entered without the leading “0.”

  • FIXED Fixed an issue that was causing the inclFerryDist parameter setting to be ignored in CalcMiles reports.

April 9, 2020

  • IMPROVED A new endpoint, /updatedplaces , has been added to the Places API to allow users who store location information locally to check whether a Place has recently been updated.

April 8, 2020

  • IMPROVED Hours of Service reports will not include rest stops in the U.S. that are known to be closed due to COVID-19.

  • NEW Updated to 2020 Q1-A data in Europe.

March 16, 2020

  • IMPROVED Reverse geocoding will now return intersecting street names when a lat/lon is at or near an intersection.

March 10, 2020

  • NEW Updated to 2020 Q1 data in North America.

  • NEW The following enhancements were made to our Single Search and Reverse Geocoding services:

    • A new parameter, includeTrimblePlaceIds, allows you set whether search should return the TrimblePlaceId for a location, if one exists. Trimble Maps maintains an ever-growing Places database that includes tens of thousands of commercial locations across North America that serve the transportation industry. Places provide additional information about a location—ranging from entry and exit gates to site hours—that can be called using our new Places API .

      Every location in the Places database is identified by a unique TrimblePlaceId. That ID ensures you receive the exact same information about a Place—address, contact information, etc.—regardless of whether you are calling the Places API from your transportation management system (TMS) or accounting software.

      In Single Search, TrimblePlaceId is returned as a separate field, while Reverse Geocoding returns it within a field titled PlaceName.

    • Single Search geocoding in Europe has been enhanced using point addressing. Point addressing assigns GPS coordinates to each street address, which can improve routing accuracy—especially in densely populated urban areas.

Feb. 20, 2020

  • IMPROVED Multiple enhancements were made to the Time Window Routing API , including:

    • A new DeliveryType parameter that allows you to identify whether the stop is a delivery or a pickup. The value is used to better cluster together deliveries and pickups—ideally to make deliveries first and complete pickups after all deliveries are made.
    • Better support of stop locations that contain postal codes.
    • Improved break time calculations.
    • General performance improvements, including the use of live traffic closures in route calculations. (Account must be licensed for traffic.)

  • IMPROVED Tunnel categories used for hazardous materials routing are now automatically identified based on the worldwide region.

  • IMPROVED Geocoding of intersections as well as geocoding of addresses with a directional component (North, South, East, West) has been enhanced.

  • IMPROVED The TollDistance field is no longer returned in toll reports for Europe if the toll system is not distance-based.

  • IMPROVED Geocoding was improved in the Netherlands.

  • IMPROVED Traffic map tiles can now show traffic up to a map zoom level of 20.

  • IMPROVED Traffic incidents map tiles now show more real-time incidents and provide better translations in Europe.

  • FIXED Fixed an issue where incorrect Point of Interest (POI) data was being returned in certain cases.

  • FIXED Fixed an issue in the Time Window Routing API that prevented a stop from properly being removed when it has a later start time than end time.

  • FIXED Fixed an issue that could cause the Time Window Routing API to return different results when the same stops are passed in a different order.

Jan. 8, 2020

  • NEW Updated to 2019 Q4 data in Europe.

  • IMPROVED ETA calculations were improved when no traffic information is being used for routes in Europe.

  • FIXED Fixed an issue that could cause a geocoding error if a route number is included in addition to the local street name.

  • FIXED Toll costs were added for the Liefkenshoektunnel between Antwerp and Beveren in Belgium.

Nov. 20, 2019

  • IMPROVED The following language enhancements were made to our Geocoding APIs:

    • Translations for country and county are now returned when the lang parameter is set. Previously, only city names were translated.

    • If the lang parameter is not set, the city and street name will be returned in the local language based on the geocoded location.

Oct. 10, 2019

The following enhancements were made to our Single Search service:

  • NEW Updated to 2019 Q3 data in Europe and 2019 Q2 data Worldwide.

  • NEW Added a new boolean parameter called separateHN that returns a house number as a separate field from the rest of the street address.

  • IMPROVED Enhanced the ability to search for a lat/lon plus an address. You must now pass the keyword latlon when a search includes a lat/lon and an address. The new format is: latlon:“40.361007, -74.599268”, 1 Independence Way

  • IMPROVED Multiple geocoding improvements, including enhanced searches for:

    • Street names with special characters in Polish

    • Street names that include “Rue de la” (French street type)

    • Street names with “Old” or “Olde”

    • City and state at the beginning of a search string

Sept. 9, 2019

  • NEW A new endpoint in our Places API generates a URL that opens a map in the ContentTools user interface where you can view and edit a custom Place.

Sept. 5, 2019

The following enhancements were made to our Single Search service:

  • NEW Updated to 2019 Q3 data in North America.

  • NEW Added support for the “@” symbol when entering an intersection in single search. (For example, “Main Street @ First Avenue”.)

  • IMPROVED Multiple geocoding improvements, including:

    • General improvements in speed and quality of matches for searches.

    • Improved handling of “fielded” locations. (Locations entered by separate fields such as address, city, state, etc.)

    • Improved handling of house numbers that have a leading zero.

    • Better results when values are repeated in a search. (For example, a search for “1 Independence Way Princeton Princeton NJ.)

Sept. 4, 2019

  • NEW A new premium add-on for our Route Reports API allows you to generate detailed toll costs for commercial vehicle routes in Europe. The new Toll Detail report provides toll information for each segment of the route as well as an overall summary of tolls, by country—helping you understand exact toll costs as part of your route planning. This new feature provides:

    • Regularly updated toll information for toll structures, administrative area tolls, toll collection systems, and distance-based tolls.

    • Built-in currency conversion rates, updated daily, so you can calculate costs in your currency of choice.

    • Coverage for the majority of Western Europe.

Contact us if you’re interested in learning more about this feature.

June 24, 2019

Our annual version release incorporates the latest map data as well as routing, location and mapping API enhancements that have been made throughout the year. Highlights for version 33 of PC*MILER Web Services, include:

  • IMPROVED ETA calculations using additional data. ETA calculations have been improved by taking into account factors such as truck speed limits by jurisdiction, red lights and other delays at intersections, and average speeds on lower class local roads.

  • IMPROVED Routing for deliveries on local roads. The routing algorithm has been improved to generate better routes for deliveries on roads specified as “No Thru Traffic” or “Delivery Only,” which are usually classed as local roads.

  • IMPROVED Turn logic for smaller vehicles. Routing now better reflects the reality that light duty vehicles (i.e. commercial truck classes 1, 2, and 3) are more capable than heavy-duty trucks, and sometimes medium-duty trucks, of negotiating sharp turns. It is now more likely for routes to be generated for smaller-sized vehicles via turns it might have avoided in past versions—resulting in more practical routes.

  • NEW Commercial vehicle specific data, including:

    • Improving street-level maps, including weight limits, vertical clearances and truck through-travel restrictions.
    • Adding newly constructed roads and exit interchanges.
    • Improving city and ZIP/Postal Code placement and alignment.
    • Improving geocoding to better match an address to its actual “ground truth” latitude/longitude point.
    • Improving geocoding to better match road name abbreviations (for example, “BVD” or “BLVD” with “Boulevard”), better handle spacing in addresses, and improve house number and postal code matching.
    • Enhancing reverse geocoding to return the city name in the language provided.
    • Implementing customer-recommended map improvements submitted via MapSure, our easy-to-use, online map reporting tool—directly into map data.
    • Improving matches when user enters an incorrect string.

  • IMPROVED The Sites feature, which defines a boundary around a Place so you can route vehicles to entrances and exits, generate more accurate directions, and provide better time and distance estimates, has been enhanced.

    • If you enter a stop as an address, and that address falls within a defined Site, the Site information will be used in routing and the Site will be shown on the map.
    • Routing into and out of Site gates has been improved to account for the Gate Path. Gate Path is a setting in ContentTools—the web tool where you can create Sites to be shared with your licensed Trimble Maps products—that specifies which roads you want drivers to take to approach or to depart a Site.
    • Additional predefined Sites have been added to ContentTools for a total of about 9,400 distribution centers, intermodal terminals, manufacturing plants, and truck stops.

Other improvements in this release:

  • NEW Europe Emissions is a new feature to calculate “Tank-To-Wheel” (TTW) greenhouse gas (GHG) emission estimates. It addresses direct emissions when running a vehicle on a specific route, and provides this information in the State or Mileage reports.
  • IMPROVED In mileage look-ups, if no ZIP code is provided with a city name, the city center will be used.
  • IMPROVED Fastest routing in Europe, using additional road speed data.
  • IMPROVED Four new parameters have been added to the response from our Time Window Routing API : UniqueClusterID, TimeWindow, BlockTimeWindow, and WaitTime. These are existing, optional parameters in the POST request body. If they are not used in the request, they can be ignored in the response.

May 28, 2019

The following enhancements were made to our Single Search service:

  • IMPROVED City and street matches when a user enters an incorrect string
  • IMPROVED Matching of “CR” with “County Route”
  • IMPROVED Speed of geocoding at intersections in certain areas
  • IMPROVED Postal code matching in Sweden
  • IMPROVED Relevance of POI searches to the current location
  • FIXED “Virgin Islands, U.S.” and “Virgin Islands, British” now taken into consideration in searches
  • NEW Updated data to EU 19Q1-A, and NA 19Q1.2

May 6, 2019

  • NEW Upgraded to North America 19Q1.2 map data
  • FIXED The WeatherAlerts report to only account for alerts along the route.
  • FIXED Geocoding failures on a few numbered streets in Calgary, AB, and Edmonton, AB, in Canada.
Last updated May 24, 2023.
Contents