Transitland v2 Routing API

Available on the following API tiers:

Transitland v2Beta by invite

The Transitland Routing API plans routes from an origin/start location to a destination/stop location by transit and other modes of travel.

The Transitland Routing API is powered by the same archive of GTFS archives as the other Transitland v2 APIs. Users can combine itineraries from the Transitland Routing API with queries performed against other Transitland v2 APIs.

Available only by invite during beta. Complete this form to express your interest.

Online vs. batch usage

The public Transitland Routing API is intended for "online" purposes such as interactive web or mobile applications.

For batch purposes, such as analyzing transit travel between thousands or millions of origin/destination pairs that are known in advance, Interline also offers a full-service option. Contact Interline for more information about batch routing analysis.

Geographic coverage

For beta release, coverage is all current operators in the United States.

In the future, we expect to increase routing coverage to match worldwide coverage offered by other Transitland v2 APIs.

Modes of travel

Transitland Routing APIs support travel by transit and walking.

In the future, additional modes of travel may be supported.

Features and benefits

The beta release of Transitland Routing API provides the following features and benefits:

  • Broad coverage in one routing engine: Transit routing across all locations in the United States where Transitland has GTFS source feed coverage (to be expanded worldwide in the future). No need to maintain separate routing engines for each metro region.
  • Rapidly updating schedules: When the Transitland platform receives new versions of source feeds, the new routing graph tiles are rapidly created behind the scenes. Transitland Routing API switches to using the new source feed version's service schedules within minutes. No need to wait hours or days for the routing engine to rebuild.
  • Compatible APIs: Transitland Routing API beta is released with an API endpoint that is compatible with OpenTripPlanner. We may add additional compatibility modes in the future, such as a Google Directions API compatibility endpoint.

Known limitations

Transitland Routing API is a beta release and is under ongoing development. The following are known limitations:

  • Journey itineraries:
    • Pedestrian legs include a shape, origin, and destination, which is sufficient for plotting on a map; pedestrian legs do not include detailed street names or maneuver routing for narrative instructions.
  • Stops and routes:
    • pickup_type or drop_off_type > 0 not supported.
    • continuous_pickup and continuous_drop_off not supported
    • Loop routes not well supported.
  • Timezones:
    • Trips spanning multiple timezones are not well supported.
  • Transfers:
    • Transitland Routing API doesn't make use of block_id in trips.txt when calculating transfers.
    • Transitland Routing API doesn't make use of transfers.txt when calculating transfers.
    • Transfers after midnight are not well supported.
  • GTFS Realtime:
    • Transitland Routing API doesn't make use of GTFS Realtime TripUpdates or VehiclePositions.
  • Performance:
    • Users of the beta may intentionally be slowed or rate limited in their use.

OTP-compatible API endpoint

The beta release of the Transitland Routing API provides an endpoint that supports the main request options and response type as OpenTripPlanner's plan REST API.

Software libraries designed to work with the OTP REST API will also likely work with the Transitland Routing API.

OpenTripPlanner (OTP) is an open-source transit trip planner. No code from the OTP project is used to power the Transitland Routing API.

Endpoint

Submit requests to

https://transit.land/api/v2/routing/otp/plan

Requests may use GET or POST methods.

Query parameters

The Transitland Routing API in OTP compatibility mode currently supports the following query parameters.

Basic routing plan query parameters:

The following query parameters are required for every request:

nametypedescription and example
fromPlacecoordinatesOrigin in "lon,lat" format, e.g. "37.7757,-122.47996"
toPlacecoordinatesDestination in "lon,lat" format, e.g. "37.7757,-122.47996"
timestringDepart from origin, HH:MM:SS in local time
datestringDepart from origin, YYYY-MM-DD in local time (MM-DD-YYYY also supported)

Advanced routing plan query parameters:

The following query parameters are optional additions. If not specified in the request, the default value will be used.

nametypedefaultdescription
arriveBybooleanfalseWhen set, time and date will be used as target "arrival time" at destination instead of departure from origin
maxItinerariesinteger10Number of returned itineraries. Can also be specified as numItineraries.
maxWalkingDistancefloat800Maximum walking distance (in meters) from origin to first stop or last stop to destination. Can also be specified as maxWalkDistance.
maxTransferWalkingDistancefloat400Maximum distance (in meters) to consider for transfers, e.g. the last stop of one leg and the first stop of the next leg. This is a straight line distance.
walkingSpeedfloat1.0Walking speed (meters per second). Cannot be changed in beta release.
minRideLengthinteger120Minimum duration (in seconds) of a transit vehicle leg
maxKinteger8Maximum number of transit legs
maxTripTimeinteger14400Maximum itinerary time (in seconds)
transferTimePenaltyinteger120Amount of padding to add (in seconds) when considering a transfer. For example, when alighting from the end of the first transit leg and walking to the departure stop for the next leg, only transfers to new trips departing at least 120s from that moment will be considered

Advanced query parameters to control service-schedule fallback:

When transit agencies have not released up-to-date GTFS feeds, Transitland v2 APIs can fallback to an automatically selected substitute schedule:

nametypedefaultdescription
useFallbackDatesbooleanfalseUse "fallback" service dates if the requested date is outside the service period of a given feed. For instance, if a feed only contains service from 2023-01-01 through 2023-01-31, and a date of 2023-05-01 is specified, an equivalent weekday (in this case, Monday) will be selected within the valid service range, such as 2023-01-09.

Query parameters to control walking itinerary:

nametypedefaultdescription
includeWalkingItinerarybooleanfalseInclude a walking-only itinerary regardless of transit plan results
fallbackWalkingItinerarybooleanfalseInclude a walking-only itinerary if no transit trips were found
allowWalkingItinerarybooleanfalseInclude a walking-only itinerary by default if the origin and destination are within maxWalkingDistance

Query parameters for debugging routing algorithm:

nametypedefaultdescription
includeEarliestArrivalsbooleanfalseInclude a table of the earliest arrival time of each stop visited during trip planning
useTargetStopPruningbooleantrueDo not consider stops that can not improve end goal arrival times. Set to false to consider all possible transfers, which is useful for generating isochrones.

Example request

This is a basic example of a request to the OTP-compatible routing API endpoint:

https://transit.land/api/v2/routing/otp/plan?fromPlace=37.7757,-122.47996&toPlace=37.76845,-122.23508&date=2023-12-07&time=17%3A59&api_key=xxx

Example response contents

Below is an example of a response from the OTP-compatible API endpoint. Comments describing some of the fields are prefixed with //:

{
  "plan": {
    "date": 1701936000000, // UNIX timestamp (milliseconds since the UNIX epoch)
    "from": { // the starting point
      "lat": 37.7757,
      "lon": -122.47996,
      "name": "Origin"
    },
    "to": { // the ending point
      "lat": 37.76845,
      "lon": -122.23508,
      "name": "Destination"
    },
    "itineraries": [ // each itinerary represents a different set of legs to travel from the origin to the destination
      {
        "duration": 5518, // duration of entire journey from origin to destination (in seconds)
        "distance": 26790.81627237679, // distance of entire journey from origin to destination (in meters)
        "startTime": 1702000804000, // UNIX timestamp departing origin (milliseconds since the UNIX epoch)
        "endTime": 1702006322000, // UNIX timestamp arriving at destination (milliseconds since the UNIX epoch)
        "walkTime": 1071, // duration of portion of journey walking (in seconds)
        "walkDistance": 1239.830214249393, // distance of portion of journey walking (in meters)
        "transitTime": 3165, // duration of portion of journey on a transit vehicle (in seconds)
        "transitDistance": 25550.986058127397, // distance of portion of journey on a transit vehicle (in meters)
        "waitingTime": 1282, // duration of portion of journey waiting for a transit vehicle (in seconds)
        "transfers": 2, // number of transfers between transit vehicles/routes
        "legs": [ // each leg represents a portion of the journey walking or on a transit vehicle/route
          { // the 1st leg represents walking to a transit stop
            "startTime": 1702000804000, // UNIX timestamp (milliseconds since the UNIX epoch)
            "endTime": 1702001402000, // UNIX timestamp (milliseconds since the UNIX epoch)
            "distance": 598.4352733053502, // meters
            "duration": 598, // seconds
            "mode": "WALK", // the travel mode of the leg
            "transitLeg": false, // is the travel mode a variety of transit?
            "from": { // the starting point of this leg
              "lat": 37.7757,
              "lon": -122.47996,
              "name": "",
              "departure": 1702000804000 // UNIX timestamp (milliseconds since the UNIX epoch)
            },
            "to": { // the ending point of this leg; in this case, boarding a bus
              "lat": 37.77266,
              "lon": -122.48061,
              "name": "Fulton St & 22nd Ave", // name of the transit stop
              "departure": 1702001402000, // UNIX timestamp (milliseconds since the UNIX epoch)
              "stopId": "14747", // stop ID can be used 
              "stopCode": "14747"
            },
            "steps": [],
            "legGeometry": {
              "points": "caqeFvzpjV??@b@rEOrJ[??IuEN~IN???", // the geometric shape of this leg, in encoded polyline format. For more information about how to decode see https://developers.google.com/maps/documentation/utilities/polylinealgorithm
              "length": 10
            }
          },
          { // the 2nd leg represents riding a bus route
            "startTime": 1702001402000,
            "endTime": 1702002922000,
            "distance": 5976.1712544764105,
            "duration": 1520,
            "mode": "BUS",
            "transitLeg": true,
            "from": { // stop to board the bus
              "lat": 37.77266,
              "lon": -122.48061,
              "name": "Fulton St & 22nd Ave",
              "departure": 1702001402000,
              "stopId": "14747",
              "stopCode": "14747",
              "stopIndex": 11,
              "stopSequence": 11
            },
            "to": { // stop to alight the bus
              "lat": 37.780889,
              "lon": -122.413587,
              "name": "Mcallister St & Leavenworth St",
              "departure": 1702002922000,
              "stopId": "17635",
              "stopCode": "17635",
              "stopIndex": 23,
              "stopSequence": 23
            },
            "steps": [],
            "intermediateStops": [ // transit stops passed along the journey
              {
                "lat": 37.772834,
                "lon": -122.476524,
                "name": "Fulton St & Park Presidio",
                "departure": 1702001475000, // UNIX timestamp (milliseconds since the UNIX epoch)
                "stopId": "17721",
                "stopCode": "17721",
                "stopIndex": 12,
                "stopSequence": 12
              },
              {
                "lat": 37.773067,
                "lon": -122.471699,
                "name": "Fulton St & Park Presidio Blvd",
                "departure": 1702001561000,
                "stopId": "14232",
                "stopCode": "14232",
                "stopIndex": 13,
                "stopSequence": 13
              },
              {
                "lat": 37.77325,
                "lon": -122.46761,
                "name": "Fulton St & 10th Ave",
                "departure": 1702001634000,
                "stopId": "14737",
                "stopCode": "14737",
                "stopIndex": 14,
                "stopSequence": 14
              },
              {
                "lat": 37.773318,
                "lon": -122.465739,
                "name": "Fulton St & 8th Ave",
                "departure": 1702001668000,
                "stopId": "14735",
                "stopCode": "14735",
                "stopIndex": 15,
                "stopSequence": 15
              },
              {
                "lat": 37.773532,
                "lon": -122.463837,
                "name": "Fulton St & 6th Ave",
                "departure": 1702001700000,
                "stopId": "14733",
                "stopCode": "14733",
                "stopIndex": 16,
                "stopSequence": 16
              },
              {
                "lat": 37.774282,
                "lon": -122.458003,
                "name": "Fulton St & Arguello Blvd",
                "departure": 1702001816000,
                "stopId": "14224",
                "stopCode": "14224",
                "stopIndex": 17,
                "stopSequence": 17
              },
              {
                "lat": 37.77499,
                "lon": -122.45238,
                "name": "Fulton St & Shrader St",
                "departure": 1702001927000,
                "stopId": "14234",
                "stopCode": "14234",
                "stopIndex": 18,
                "stopSequence": 18
              },
              {
                "lat": 37.775773,
                "lon": -122.446289,
                "name": "Fulton St & Masonic Ave",
                "departure": 1702002060000,
                "stopId": "14230",
                "stopCode": "14230",
                "stopIndex": 19,
                "stopSequence": 19
              },
              {
                "lat": 37.77773,
                "lon": -122.43851,
                "name": "Mcallister St & Divisadero St",
                "departure": 1702002262000,
                "stopId": "15390",
                "stopCode": "15390",
                "stopIndex": 20,
                "stopSequence": 20
              },
              {
                "lat": 37.778618,
                "lon": -122.431744,
                "name": "Mcallister St & Fillmore St",
                "departure": 1702002420000,
                "stopId": "15392",
                "stopCode": "15392",
                "stopIndex": 21,
                "stopSequence": 21
              },
              {
                "lat": 37.780052,
                "lon": -122.420178,
                "name": "Mcallister St & Van Ness Ave",
                "departure": 1702002660000,
                "stopId": "15405",
                "stopCode": "15405",
                "stopIndex": 22,
                "stopSequence": 22
              }
            ],
            "legGeometry": {
              "points": "qnpeFx~pjV?AGgCIuEIuEIuE@g@KoDIuEI_FIaFCiB?QEwAGuEIuEIuEAuAGaCGsE?a@EmAKgBUcEEOYsE[uE[sEYuE[_FEkAk@sIYmEMqBk@oICg@GuA[kEk@iISkDS{CO{BYcEA_@g@qH{Dd@i@iIi@gIi@iIa@kHG_@i@mIi@gIi@iIi@gI@AWkDUiDoAcSsAqSk@iIa@}GAi@@KC]c@_Hi@iIK[OeCScDi@gI?M?E",
              "length": 73
            },
            "agencyId": "SF", // the agency operating the bus route
            "agencyName": "San Francisco Municipal Transportation Agency",
            "routeShortName": "5R", // the bus route
            "routeLongName": "FULTON RAPID",
            "routeType": 3, // the GTFS route vehicle type
            "routeId": "SF:5R",
            "routeColor": "BF2B45", // color suggested by the agency source feed (as hexadecimal HTML color code)
            "routeTextColor": "FFFFFF", // color suggested by the agency source feed; or defaults to white (as hexadecimal HTML color code)
            "tripId": "SF:11391893_M11",
            "headsign": "Transit Center",
            "feedId": "f-sf~bay~area~rg", // Onestop ID for the Transitland source feed from which this schedule comes
            "feedVersionSha1": "76d347787aed1233dacb4e268023dd481b08e88f" // SHA1 hash for the Transitland feed version from which this schedule comes
          },
          { // the 3rd leg represents walking from a bus stop to a rail stop
            "startTime": 1702002922000,
            "endTime": 1702003192000,
            "distance": 360.42352323426013,
            "duration": 270,
            "mode": "WALK",
            "transitLeg": false,
            "from": {
              "lat": 37.780889,
              "lon": -122.413587,
              "name": "Mcallister St & Leavenworth St",
              "departure": 1702002922000,
              "stopId": "17635",
              "stopCode": "17635"
            },
            "to": {
              "lat": 37.779408,
              "lon": -122.413826,
              "name": "Civic Center / UN Plaza",
              "departure": 1702003192000,
              "stopId": "CIVC",
              "stopCode": "CIVC"
            },
            "steps": [],
            "legGeometry": {
              "points": "qareF|{cjV????B??HVCpAQ`@h@d@Gd@GBFX`@^d@fBbC?G????yAiD",
              "length": 18
            }
          },
          { // the 4th leg represents riding a rail route
            "startTime": 1702004400000,
            "endTime": 1702005720000,
            "distance": 18301.03634118096,
            "duration": 1320,
            "mode": "RAIL",
            "transitLeg": true,
            "from": {
              "lat": 37.779408,
              "lon": -122.413826,
              "name": "Civic Center / UN Plaza",
              "departure": 1702004400000,
              "stopId": "CIVC",
              "stopCode": "CIVC",
              "stopIndex": 5,
              "stopSequence": 5
            },
            "to": {
              "lat": 37.774841,
              "lon": -122.224081,
              "name": "Fruitvale",
              "departure": 1702005720000,
              "stopId": "FTVL",
              "stopCode": "FTVL",
              "stopIndex": 11,
              "stopSequence": 11
            },
            "steps": [],
            "intermediateStops": [
              {
                "lat": 37.78486164387391,
                "lon": -122.40685728655569,
                "name": "Powell Street",
                "departure": 1702004520000,
                "stopId": "POWL",
                "stopCode": "POWL",
                "stopIndex": 6,
                "stopSequence": 6
              },
              {
                "lat": 37.78924863397131,
                "lon": -122.40137394207487,
                "name": "Montgomery Street",
                "departure": 1702004640000,
                "stopId": "MONT",
                "stopCode": "MONT",
                "stopIndex": 7,
                "stopSequence": 7
              },
              {
                "lat": 37.79269145992349,
                "lon": -122.3970442466863,
                "name": "Embarcadero",
                "departure": 1702004700000,
                "stopId": "EMBR",
                "stopCode": "EMBR",
                "stopIndex": 8,
                "stopSequence": 8
              },
              {
                "lat": 37.804923,
                "lon": -122.295144,
                "name": "West Oakland",
                "departure": 1702005120000,
                "stopId": "WOAK",
                "stopCode": "WOAK",
                "stopIndex": 9,
                "stopSequence": 9
              },
              {
                "lat": 37.797357,
                "lon": -122.265232,
                "name": "Lake Merritt",
                "departure": 1702005480000,
                "stopId": "LAKE",
                "stopCode": "LAKE",
                "stopIndex": 10,
                "stopSequence": 10
              }
            ],
            "legGeometry": {
              "points": "ixqeFl}cjVCCoA_BmAaBmA_BmAaBmAaBmAaBmA_BmAaBmAaBmAaBkAaBmA_BmAaBmAaBmAaBmA_BmAaBmAaBmAcBkAaBmAaBmAaBkAaBmAaBmAaBmA_BmAaBmAaBmAaBmAaBmAaBkAaBmAaBkAcBmAaBmAaBkAcBgAgBaAmB}@sBw@uBw@uBw@wBw@wBu@wBu@wBu@wBu@yBu@wBs@yBu@wBu@wBu@yBs@yBu@wBu@wBu@yBs@wBu@yBu@wBu@yBs@wBu@yBs@wBu@yBu@wBu@yBo@{Bm@}Bi@_Cg@_Cc@aCa@cC]eCYeCYeCWgCWeCWgCWgCWeCUgCWgCUeCUgCWgCWeCUgCWgCUeCWgCWgCUeCWgCWgCUeCWgCUgCWeCUgCWgCWeCUgCWgCUeCWgCWgCUeCWgCUgCWeCWgCUgCWeCUgCWgCWeCUgCWgCUeCWgCUgCUgCQgCQgCQiCMgCMiCKiCKiCIiCGiCGiCEiCEiCEiCAiC@iC@kCDiCDiCFiCFiCHiCJiCLiCJgCLiCJiCJiCJgCLiCJiCLiCLgCLiCLiCLgCJiCLiCJgCNiCLiCFiCLgCLiCLiCLgCNiCNgCPiCPgCVgCVeCZeC\\eCZeC\\cCZeC\\eC\\cC\\eC\\cC`@eCb@aCj@}Bn@}Bp@yBr@yBn@{Bp@{Bp@{Bp@yBp@{Bp@{Bl@{Bh@_Cb@cC\\cC^eC\\cCZeC\\eC\\cC^cCd@cCj@}Bp@yBv@wBt@wBv@wBx@uBx@uBx@sB|@qBv@wBd@_CPiCFiCGiCk@}BeAiBiAgB}@qBa@aCEiCLiCVeCd@aCl@}Bp@yBr@yBt@wBz@uB|@oB~@qB|@qB|@qB|@qB~@qB~@oBbAkBhAgBhAeBlAaBlA_BlAaBlAaBjAaBhAeBfAiB`AmB|@qBx@uBr@yBn@}Bh@}Bf@aCf@_Cf@aCj@}Bn@{Br@{Br@yBr@wBr@yBr@yBr@yBr@yBt@yBr@wBv@wBv@wBx@uBx@sBv@uBx@wBx@uBx@sBz@sB|@qB~@oB`AoB`AmB`AoB`AmB`AmB`AmBbAmBdAiBfAgBjAcBnA_BlAaBjAaBhAgBdAiB~@oB|@qBz@sBz@sBx@uBz@sBx@uBz@qB~@qB|@qB`AoB~@oBn@qA",
              "length": 312
            },
            "agencyId": "BA",
            "agencyName": "Bay Area Rapid Transit",
            "routeShortName": "Blue-N",
            "routeLongName": "Daly City to Dublin/Pleasanton",
            "routeType": 1,
            "routeId": "BA:Blue-N",
            "routeColor": "0099CC",
            "routeTextColor": "FFFFFF",
            "tripId": "BA:1462323",
            "headsign": "Dublin/Pleasanton",
            "feedId": "f-sf~bay~area~rg",
            "feedVersionSha1": "76d347787aed1233dacb4e268023dd481b08e88f"
          },
          { // the 5th leg represents walking from a rail stop to a bus stop
            "startTime": 1702005720000,
            "endTime": 1702005766000,
            "distance": 123.06682360185124,
            "duration": 46,
            "mode": "WALK",
            "transitLeg": false,
            "from": {
              "lat": 37.774841,
              "lon": -122.224081,
              "name": "Fruitvale",
              "departure": 1702005720000,
              "stopId": "FTVL",
              "stopCode": "FTVL"
            },
            "to": {
              "lat": 37.7750001,
              "lon": -122.2245687,
              "name": "Fruitvale BART",
              "departure": 1702005766000,
              "stopId": "51333",
              "stopCode": "51333"
            },
            "steps": [],
            "legGeometry": {
              "points": "w{peFn{~hV??^o@LH??EJqA~BBBDG??",
              "length": 10
            }
          },
          { // the 6th leg represents riding a bus route
            "startTime": 1702005840000,
            "endTime": 1702006165000,
            "distance": 1273.7784624700307,
            "duration": 325,
            "mode": "BUS",
            "transitLeg": true,
            "from": {
              "lat": 37.7750001,
              "lon": -122.2245687,
              "name": "Fruitvale BART",
              "departure": 1702005840000,
              "stopId": "51333",
              "stopCode": "51333"
            },
            "to": {
              "lat": 37.76746,
              "lon": -122.235163,
              "name": "Broadway & Tilden Way",
              "departure": 1702006165000,
              "stopId": "51545",
              "stopCode": "51545",
              "stopIndex": 3,
              "stopSequence": 3
            },
            "steps": [],
            "intermediateStops": [
              {
                "lat": 37.77379,
                "lon": -122.227856,
                "name": "Fruitvale Av & E 9th St",
                "departure": 1702005928000,
                "stopId": "58058",
                "stopCode": "58058",
                "stopIndex": 1,
                "stopSequence": 1
              },
              {
                "lat": 37.76859,
                "lon": -122.234222,
                "name": "Broadway & Blanding Av",
                "departure": 1702006140000,
                "stopId": "58677",
                "stopCode": "58677",
                "stopIndex": 2,
                "stopSequence": 2
              }
            ],
            "legGeometry": {
              "points": "w|peFp~~hVOf@Oh@Ub@Q^IR?VFVJRBP\\T^TJHKZQ^M`@KVKXK^TJ`@NLDTJ`@N`@NLD`@N`@NPFZZPRb@@X@`@LJBJBLD^H`@L`@LTH`@JXH`@L`@Jb@J`@L`@L`@L\\J`@LRDDHFDTJRLRJVN\\THD\\V^V\\VVRLJPBRL\\VZT\\X\\VJFPLJJPVJNJRFLFRFVFTHh@D^Db@EVFj@Hj@DXFj@ANCPGNQLa@NUFIDKFOJKLQd@Sd@Jj@FZ`@N`@L\\V\\X\\V\\XV`@LV??",
              "length": 112
            },
            "agencyId": "AC",
            "agencyName": "AC TRANSIT",
            "routeShortName": "51A",
            "routeLongName": "Broadway - Santa Clara",
            "routeType": 3,
            "routeId": "AC:51A",
            "routeColor": "A30D11",
            "routeTextColor": "FFFFFF",
            "tripId": "AC:11260020",
            "headsign": "Rockridge BART",
            "feedId": "f-sf~bay~area~rg",
            "feedVersionSha1": "76d347787aed1233dacb4e268023dd481b08e88f"
          },
          { // the 7th leg represents walking from a bus stop to the destination
            "startTime": 1702006165000,
            "endTime": 1702006322000,
            "distance": 157.90459410793164,
            "duration": 157,
            "mode": "WALK",
            "transitLeg": false,
            "from": {
              "lat": 37.76746,
              "lon": -122.235163,
              "name": "Broadway & Tilden Way",
              "departure": 1702006165000,
              "stopId": "51545",
              "stopCode": "51545"
            },
            "to": {
              "lat": 37.76845,
              "lon": -122.23508,
              "name": "",
              "departure": 1702006322000
            },
            "steps": [],
            "legGeometry": {
              "points": "smoeFv`aiV??C@Ic@??qAaAw@jBm@W??",
              "length": 9
            }
          }
        ]
      }
      // remaining itineraries have been removed from this sample to save space
    ]
  }
}