DIGIT CORE
Search…
Location Module
Setting up boundary hierarchies for tenants

Overview

Location module serves the boundary hierarchies for a tenant. Location is defined separately for every tenant (mostly ULBs) in DIGIT. Each tenant has a unique tenantId.
The tenantId key can be a combination of state or state.city or state.city.ulb. The hierarchyType can be one of Revenue, Admin or Election. Multiple hierarchy types can be defined for the same city tenant.
1
{
2
"tenantId": "pb.amritsar",
3
"moduleName": "egov-location",
4
"TenantBoundary": [
5
{
6
"hierarchyType": {
7
"code": "REVENUE",
8
"name": "REVENUE"
9
},
10
"boundary": {
11
"id": 1,
12
"boundaryNum": 1,
13
"name": "Amritsar",
14
"localname": "Amritsar",
15
"longitude": null,
16
"latitude": null,
17
"label": "City",
18
"code": "pb.amritsar",
19
"children":[
20
{
Entire hierarchy can be defined in a nested way as children. One sample of location data for the Amritsar ULB is available here: https://github.com/egovernments/egov-mdms-data/blob/DEV/data/pb/amritsar/egov-location/boundary-data.json
Location data is stored in GitHub as part of MDMS. The egov-location folder needs to be created inside the city tenant (see Amritsar example above). It is stored in the following format:
Module name: egov-location (folder)
Master name: TenantBoundary (key)

Data setup for location module

Enter the boundary hierarchy data in the <tenant>/egov-location/boundary-data.json file in the appropriate branch of your forked MDMS repository. For eg., if you want changes to be visible in the Dev environment, then add the data in the DEV branch of the MDMS repository.
Follow proper Git flow processes to ensure high quality data. Ensure PR requests are raised, verified and merged especially where multiple people are working on the same branch.
Restart the MDMS service in your environment once the new data is available in the desired branch.

Localization of boundaries

Users also need to upsert localisation codes for any new boundary data in MDMS. Else, users will see the label names (auto generated) for the city names in the UI. See the Localisation Data Setup guide for more information on how to perform localisation. The localisation code should follow the following format. *tenantId*_*moduleName*_*hierarchyType*_*cityCode*_*zoneCode*_*blockCode*_*areaCode
For example, to find the localisation code for "Ajitnagar area 1", assuming tenantId as "pb" and hierarchyType as "Revenue":
  1. 1.
    moduleName: EGOV-LOCATION
  2. 2.
    cityCode: PB.AMRITSAR
  3. 3.
    zoneCode: Z1
  4. 4.
    blockCode: B1
  5. 5.
    areaCode: SUN04
So finally the localisation label code for "Ajitnagar area 1" would be PB_EGOV-LOCATION_REVENUE_PB.AMRITSAR_Z1_B1_SUN04 (shown in the UI if no localisation is present).
All content on this page by eGov Foundation is licensed under a Creative Commons Attribution 4.0 International License.
Copy link
On this page