## Connect Origins to Destinations

##

Connect Origins to Destinations measures the travel time or distance between pairs of points. The tool can report straight-line distances; distances based on a travel mode, such as walking or driving; or trip durations based on a travel mode. Using this tool, you can do the following:

- Calculate the total distance or time commuters travel on their home-to-work trips.
- Measure how far customers are traveling to shop at your stores. Use this information to define your market reach, especially when targeting advertising campaigns or choosing new store locations.
- Calculate the expected trip mileage for your fleet of vehicles. Afterward, run the Summarize Within tool to report mileage by state or other region.

You provide starting and ending points, and the tool returns a layer containing route lines, including measurements, between the paired origins and destinations.

If Use current map extent is checked, only the features that are visible within the current map extent will be considered in the analysis. If unchecked, all features in the input layer will be considered, even if they are outside the current map extent.

## Choose point layer representing the origin locations

Choose the point layer representing the origin or origins. The tool supports up to 5,000 origins and 5,000 destinations.

If you choose a layer that has exactly one origin, it will connect to all destinations.

In addition to choosing a layer from your map, you can select Choose Living Atlas Analysis Layer or Choose Analysis Layer found at the bottom of the drop-down list. This opens a gallery containing a collection of layers useful for many analyses.

## Choose the destinations layer

Choose the layer representing the destination or destinations to which the origins should connect. The tool supports up to 5,000 origins and 5,000 destinations.

If you choose a layer that has exactly one destination, all the origins will connect to that destination.

If there is one origin and many destinations, the tool connects the origin to each of the destinations.

In addition to choosing a layer from your map, you can select Choose Living Atlas Analysis Layer or Choose Analysis Layer found at the bottom of the drop-down list. This opens a gallery containing a collection of layers useful for many analyses.

If there are many origins and many destinations, you need to have two fields that describe the origin-destination pairs: ID field in origins and Matching ID field in destinations. The tool connects the origin-destination pairs during the analysis. For instance, imagine you have two origins with ID field values of `Rosie` and `Harold` and two destinations with the same ID values. The `Rosie` origin will connect to the `Rosie` destination, and `Harold` will connect to `Harold`. No other connections or measurements are made.

The ID values must be unique within each layer; for instance, the destinations layer cannot have two `Rosie` values. The values in the origin and destination layers must match exactly to make pairs; `Harold` won't connect to the misspelled value, `Harodl`.

## Measure

Choose whether to connect origins to destinations using straight-line distance or a travel mode. The output routes will follow roads or walkways and honor applicable rules, such as one-way streets and illegal turns for driving or trucking. The available travel modes are determined by the administrator of your organization.

When you choose Driving Time, Rural Driving Time, or Trucking Time you have options on how to measure the drive time.

- Uncheck Use Traffic to find the quickest routes based on fixed speeds.

  This is the option to choose if you want a general drive-time measurement, not one that is calculated using changing traffic conditions for a specific departure time.

- Check Use Traffic to find the quickest routes based on a given start time and changing traffic conditions. By also choosing the Live traffic option, the departure time from the origins is set to the current time, and current and predicted traffic speeds are referenced from sensors and feeds to create the routes. The predicted traffic speeds are calculated by referencing live traffic speeds, historical speeds, and current events such as weather. Traffic speeds are predicted 12 hours into the future, so you can move the slider to set the departure time ahead by up to 12 hours.

  Use these live-traffic settings to find the drive times for departing now, departing in one hour from now, and so on.

- By checking Use Traffic and choosing Traffic based on typical conditions for a day and time, the tool finds the quickest routes based on historical speed averages for every five-minute interval across a routine week. The results include traffic but remove the influence of current traffic conditions and events, which may vary significantly from the norm.

  You can use these historical traffic settings to ask, for instance, "How long would it generally take to reach these destinations when departing at 11:30 a.m. on a Wednesday?"

  The time you set refers to the time zone in which your origins are located. So if you set the time to 8:00 a.m. and have two origins, one in New York City and another in Los Angeles, the routes will be generated for a departure time of 8:00 a.m. Eastern Time and 8:00 a.m. Pacific Time, respectively.

Note that as a vehicle drives away from the origin, time elapses and traffic conditions change. The Connect Origins to Destinations tool accounts for these variations when you check Use traffic; however, not all regions support traffic. Click the See availability link on the tool to find out whether it is offered in your study area.

Trucking Time can use dynamic travel speeds based on traffic but only up to the legal truck speed limit. For example, if the dynamic speed for a street based on live traffic is 65 miles per hour but the truck speed limit for that street is 55 miles per hour, the calculation will use 55 miles per hour for that street.

## Result layer name

The name of the feature layer that will be created in My Content and added to the map. If the feature layer already exists, you will be asked to provide another name. The feature layer will contain a layer for each of the following: routes, unassigned origins, and unassigned destinations when some origins cannot be connected to their destinations.

If you select Include route layers, each route from the result is also saved as a route layer. A route layer includes all the information for a particular route such as the stops assigned to the route as well as the travel directions. Creating route layers is useful if you want to share the individual routes with other members in your organization or if you wish to further modify the routes using the Directions button in the map viewer. The route layers use the name provided for the feature layer as a prefix and the route name generated as part of the analysis, is added to create a unique name for each route layer.

The maximum number of route layers that can be created is 1,000. If the result contains more than 1,000 routes and Include route layers is checked, the tool will only create the output feature service.

Using the Save result in drop-down list, you can specify the name of a folder in My Content where the feature layer and the route layers, if created, will be saved.