In this article, you will learn how to set up Service Areas on your dashboard.
Service Areas enable you to define the geographic boundaries within which a service is available. When configured, these boundaries are used to:
Orders with pickup or drop-off addresses outside a configured Service Area will not be eligible for the associated service or pricing rule..
This article will cover:
- Configuring a Service Area
- Creating a GeoJSON File
- Zone Display and Map View
- Editing a Service Area
- Deleting a Service Area
Configuring a Service Area
A "Service Area" allows you to define the geographic boundaries where a service is available. When configured, these boundaries are used to:
- Restrict services to specific regions
- Power Zone-Based Pricing (ZBP) tables
- Orders with pickup or drop-off addresses outside a configured Service Area will not be eligible for the associated service or pricing rule.
To create a service area, select the "Service Area" category under the "Courier" drop-down on the left sidebar, and then select "Create service area"
Once selected, you will then be able to enter a unique name for the Service Area and upload a valid GeoJSON file by dragging or selecting the file.
Creating a GeoJSON File
Service Areas are defined by uploading a GeoJSON file. To create one, visit geojson.io and use the polygon drawing tool to outline your desired zone(s).
You can draw one or more shapes, and each shape represents a zone.
Each zone must:
- Be a closed polygon (not a line or point)
- Not overlap with other zones in the same file
You can include a name and colour for each polygon by clicking on the zone and selecting
"Add Simplestyle" properties:
-
Name: The name of the zone (If not provided, zones will be labeled Zone A, Zone B, etc.)
- Zone names must be unique within a Service Area.
- Color: The fill color of the zone (If not provided, a default color is used)
After drawing, you can move points to adjust boundaries by clicking and dragging them. To delete a shape, select it and choose “delete”.
Once your service area is defined, click on "Save" on the top menu, then select "Download GeoJSON" to save the file to your computer.
Zone Display and Map View
When you upload a GeoJSON file:
- A list of all zones is shown to the right of the map
- Each entry displays the zone’s name and a color
- Hovering over a zone displays a tooltip with the zone name
Editing a Service Area
To edit a Service Area:
- Hover over the Service Area and click Edit.
- Update the Service Area name.
- The GeoJSON file cannot be changed.
- Click "Save" to apply your changes.
Deleting a Service Area
Before deleting a Service Area:
- If it is linked to a Zone-Based Pricing rate table, you must first remove any service/rate pair assignments from clients, and then update the rate table to no longer use zone-based pricing.
- If it is assigned to a service, you must remove or replace the Service Area from that service configuration.
To delete a Service Area:
- Hover over the Service Area and click Delete.
- Confirm the deletion in the modal.