2. Add Boundary

Note: This boundary data is seeded at the city level.

Overview

This phase creates your city’s boundary hierarchy. Boundaries power routing, SLA reporting, and ward-level views.

2.1 What are boundaries?

Boundaries are the geographic divisions of your city:

• City → Zone → Ward → Block → Locality

2.2 Create boundary hierarchy

If this is a new setup, you need to define the hierarchy levels. Creating a new hierarchy is as simple as defining levels top to bottom. You can name the hierarchy anything, like "REVENUE". Set it in the BOUNDARY_HIERARCHY variable. This generates a template that you can fill and upload. The calls are idempotent so it will not create new ones.

The output of running this cell will look like this. It stores the generated template in the upload folder directly.

2.3 Fill the boundary template

Open the downloaded Excel file.

Fill in boundary data:

Code	Name	Parent Code
PG_CITYA	City A	(leave empty)
PG_CITYA_Z1	Zone 1	PG_CITYA
PG_CITYA_Z1_W1	Ward 1	PG_CITYA_Z1
PG_CITYA_Z1_W1_B1	Block 1	PG_CITYA_Z1_W1

Important Rules:

• First level (City) has no parent

• All other levels must have a valid parent code

• Codes must be unique

2.4 Upload and process

2.5 Check results