Compares a layer of existing sites with a layer of proposed new ones. Each reachable H3 cell is reached by existing sites only, new sites only, or both: a cell both reach is cannibalised, and a cell only the new sites reach is new market.
The tool sends one /h3 search per location. If any of them fails, the whole run fails, whatever the Robust Mode setting: a missing location would make the answer wrong rather than smaller.
| Description | |
|---|---|
| Existing Sites | The point layer of sites trading today |
| Existing Sites ID | The field identifying each existing site in the output |
| New Sites | The point layer of proposed sites |
| New Sites ID | The field identifying each new site in the output. Must not share an ID with an existing site. |
| Travel Mode | Any of the 13 transport modes the Custom tools offer |
| Departing / Arriving | Whether journeys depart from the locations or arrive at them |
| Time Zone | The time zone the departure or arrival time is in |
| Departing / Arriving Time | The departure or arrival time |
| Travel time (in minutes) | The maximum journey time. The limit depends on the resolution, as for H3 Custom. |
| Resolution | The size of the cells, from 4 (largest) to 12 (smallest). Defaults to 8. |
| Output Layer | Where to save the cell layer - must be in the project geodatabase |
| Output Summary Table | Where to save the per-site summary table - must be in the project geodatabase, with a different name from the Output Layer |
The optional Transportation options, Search range, Snapping and Remove Water Bodies are described on Common parameters.
A polygon layer with one row per reachable cell:
| Field | Description |
|---|---|
h3_id | The H3 cell ID |
coverage | existing only, new only or cannibalised |
existing_sites / new_sites | How many sites of each layer reach the cell |
existing_ids / new_ids | Which sites they are, as a readable list of up to 250 characters, ending +N more when it doesn't fit. Use existing_sites / new_sites for counting. |
The Output Summary Table has one row per site in either layer:
| Field | Description |
|---|---|
site | The ID of the site the row is about |
role | existing or new |
cells_reached | How many cells the site reaches |
cells_exclusive | Cells no site of the other layer reaches: retained trade for an existing site, new market for a new one |
cells_shared | Cannibalised cells the site reaches. A cell reached by several sites counts once for each. |
The run also reports the split between the three kinds of cell, and the cannibalised share of all cells.