Configure the Distance Priority Algorithm

The Distance Priority Algorithm compares the location of the shipping destination address with source locations to determine the closest source to fulfill shipments. The distance may be determined by physical distance or time spent traveling from one location to another, using database data or driving, walking, or bicycling directions. Use this Source Selection Algorithm to recommend the closest source to shipping destination addresses.

If you are using the Distance Priority Algorithm, entering the full street address and GPS coordinates for your sources is recommended.

You have two options for calculating the distance and time to find the closest source for shipment fulfillment:

  • Google MAP - Uses Google Maps Platform services to calculate the distance and time between the shipping destination address and source locations. This option uses the source’s Latitude and Longitude (GPS coordinates) and may use the street address depending on the computation mode. A Google API key is required with Geocoding API and Distance Matrix API enabled, and you may incur charges through Google.

  • Offline Calculation - Calculates the distance using downloaded and imported geocode data using zip/post codes and GPS coordinates to determine the closest source to the shipping destination address. To configure this option, you may require developer assistance to initially download and import geocodes using command-line instructions.

For multi-store website with several countries, configure the default tax destination for each country.

Use Google Maps

You do not need a Google account to get started. The process includes Google account and project creation, if needed. This option requires a billing account and payment method added to your Google account to complete configurations and use the algorithm.
However, Google MAP distance-based algorithm is recommended as more advanced and precise in comparison to Offline Calculation.

Step 1: Create the Google API key

The key is from the Google Maps Platform and should have Geocoding API and Distance Matrix API enabled. For details, see Configuring Distance Priority Algorithm.

  1. Visit Google Maps Platform and click Get Started.

  2. To enable the platform, select Maps, Routes, and Places and click Continue.

    Google Maps Platform for your Key {width="350" modal="regular"}

  3. Sign in with a Google account or create an account.

  4. Set up a project:

    • Select a project or enter a new project name.

    • To accept the terms, select Yes.

    • Click Next.

  5. Enter a billing account or create one. You can skip and add a billing account later.

    A billing account is required to use this service.

  6. To open and configure your Google Cloud Platform options, click Console.

    • Open your project.

    • Expand the menu and click APIs & Services > Library.

      Google API Services {width="350" modal="regular"}

    • Search for Geocoding API and Distance Matrix API. Select and enable each service.

  7. Expand the menu, click APIs & Services > Credentials, and copy the Google API Key.

    Google API Key Copy {width="350" modal="regular"}

Step 2: Configure the Google MAP Provider

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel, expand Catalog and choose Inventory.

  3. Expand Expansion selector the Distance Provider for Distance Based SSA section and set Provider to Google MAP.

    Providers for Distance-Based SSA {width="350" modal="regular"}

  4. Expand Expansion selector the Google Distance Provider section and configure the settings:

    • For Google API Key, enter the key copied from your Google account.

    • For Computation mode, select a configuration.

      note note
      When using this algorithm for shipping, if routes and data do not return for the selected Computation mode (driving, bicycling, or walking) for a shipment, the SSA defaults to using the Source Priority. Setting the priority for sources per stock is recommended.
      table 0-row-2 1-row-2 2-row-2 3-row-2
      Option Description
      Driving (Default) Requests standard driving directions using the road network.
      Walking Requests walking directions using pedestrian paths and sidewalks (where available).
      Bicycling Requests bicycling directions using bicycle paths and preferred streets (where available). The Distance Matrix Service is only available in the US and some Canadian cities.
    • For Value, select a value type:

      table 0-row-2 1-row-2 2-row-2
      Option Description
      Distance (Default) Returns the distance between points in metrics (kilometers and meters) or imperial (miles and feet).
      Time to Destination Returns the time required to travel from the source locations to the shipping address in hours and minutes.

    Google Distance Provider {width="350" modal="regular"}

  5. When complete, click Save Config.

Use offline calculation

Offline calculations use country codes to determine the distance between the shipping destination and source addresses. This option may require developer assistance to configure. Use an Inventory Management CLI command to download and import data from

Imported geocodes from [][5] have limitations for some countries, such as Canada and Ireland. Refer to [GeoNames Postal Code files][6] for more information.

Step 1: Download and import geocodes

Complete command-line configuration to download and import geocodes countries to ship to and have source locations in. This step may require developer assistance for help with command-line tasks. Refer to Import geocodes.

Complete these commands anytime you want to add more geocodes.

Step 2: Set the calculation

  1. On the Admin sidebar, go to Stores > Settings > Configuration.

  2. In the left panel, expand Catalog and choose Inventory.

  3. Expand Expansion selector the Distance Provider for Distance Based SSA section.

  4. Deselect the Use system value checkbox and set Provider to Offline Calculation.

    Distance Providers for Distance Based SSA {width="350" modal="regular"}

  5. When complete, click Save Config.