RESTful APIs

Release Notes

Contents

Dec. 14, 2022

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.

  • IMPROVED Traffic incidents were added to the Trip Management Notifications Service. Incidents include construction, road closures, congestion, accidents, and other events that may cause traffic delays.

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

July 26, 2022

  • NEW A new Trip Management Notifications Service allows you to register your integration to receive real-time notifications as they become available for the following events during a trip: ETA, Stop status, Weather, Out-of-corridor (OoC), Out-of-route (OoR). This push notifications service replaces the legacy polling service, which required repeated API calls to pull new notifications.

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.

June 6, 2022

The following updates were made in the Trip Management APIs:

  • FIXED Fixed an issue that caused the Modify Trip API to return an error if hosSolution is set to 0.
  • FIXED Fixed an issue that caused a “String reference” error when calling Update StopStatus.
  • FIXED Removed an unnecessary HTML line break that appeared in Next Stop field on Trip Viewer pages.

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 7, 2022

The following updates were made in the Trip Management APIs:

  • IMPROVED Added Label information to the Get Trip Notifications API response.

  • IMPROVED Improved response times for Plan Trip API calls. The average response time is now nearly 20 percent faster.

  • IMPROVED Improved storage and performance of GPS ping caching.

  • FIXED Fixed an issue where GET Trip calls using tmsTripId as the trip identifier were sometimes returning this 400 error: [“ArgumentException”,“description”:“Cannot find a trip that matches the supplied trip id.”]

  • FIXED On Tuesday, April 5, from 8 to 8:30 a.m. and 10 to 10:30 a.m. EDT, the service experienced temporary outages due to external factors. This could affect any trips created during that time.

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 15, 2022

  • FIXED Fixed an issue with Weather Alerts in the Trip Management APIs timing out and not showing alert details. (See example weather alert below.)

Example alert 

"weatherAlert":{
   "id":"https://alerts.weather.gov/cap/wwacapget.php?x=PA1263E875BD78.WinterStormWarning.1263E892D840PA.CTPWSWCTP.f76d1398bcf5cdabf05a02c1c36d8026",
   "dispUpdated":"2022-03-11T04:26:00-05:00",
   "dispPublished":"2022-03-11T04:26:00-05:00",
   "title":"Winter Storm Warning issued March 11 at 4:26AM EST until March 12 at 7:00PM EST by NWS",
   "summary":"...WINTER STORM WARNING IN EFFECT FROM 4 AM TO 7 PM EST SATURDAY... * WHAT...Heavy snow expected. Total snow accumulations of 5 to 7 inches. Winds gusting as high as 45 mph. * WHERE...Portions of central Pennsylvania. * WHEN...From 4 AM to 7 PM EST Saturday.",
   "alertEvent":"Winter Storm Warning",
   "dispEffective":"2022-03-11T04:26:00-05:00",
   "dispExpires":"2022-03-12T19:00:00-05:00",
   "status":"Actual",
   "category":"Met",
   "urgency":"Expected",
   "severity":"Moderate",
   "certainty":"Likely",
   "areaDesc":"Blair; Columbia; Huntingdon; Juniata; Mifflin; Montour; Northumberland; Schuylkill; Snyder; Southern Centre; Southern Clinton; Southern Lycoming; Union",
   "countryCode":"US"
},
"publishedOn":"2022-03-11T15:51:34+00:00"
},
"notificationType":"\"Weather"

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.

March 3, 2022

  • FIXED Fixed an issue in the Trip Management APIs where rest stops would repeat if recalculate was called twice in under 500 milliseconds.

Feb. 24, 2022

Feb. 8, 2022

  • IMPROVED Updated to Q1 2022 data in North America.

  • FIXED Fixed an issue in the Trip Management APIs that caused oocThreshold to return as “null” after Modify or Recalculate Trip API calls. The “Out of Corridor” or OoC threshold is the distance a vehicle or GPS ping departs from the planned route at which the Trip Management service generates an OoC event notification.

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

Jan. 5, 2022

The following updates were made in the Trip Management APIs:

  • IMPROVED The device time of an alert (DeviceDT) was added to ETA Alerts.
  • FIXED Fixed an issue where HOS stops were immediately flagged as “At Risk.”
Last updated June 7, 2024.
API Endpoint:
AWS Azure
Contents