Administrative Boundaries Shapefiles

Administrative Boundaries Shapefiles

This page describes the steps FEWS NET uses to create, update, and published standardized subnational administrative boundaries shapefiles.

FEWS NET uses standard subnational administrative boundary shapefiles as the foundational unit of analysis and for mapping products across FEWS NET mechanisms. 

Administrative boundaries should be reviewed and updated before any FEWS NET work begins in a country of interest or when FEWS NET staff are alerted to boundary changes or new boundary data.

In general, responsibilities by team are as follows:

  • Knowledge Base staff will complete this process for countries as new livelihoods or market fundamentals projects begin.

  • Decision Support staff will complete the process for countries that are onboarded as food security monitored countries or for ad-hoc requests.

  • Hub staff will complete the process for other countries requested by the client for ad-hoc projects.

Process overview

The standardization process aims to deliver shapefiles that meet the following standards: 

  • Administrative units have standard attributes and metadata.

  • Administrative units are edge-matched to FEWS NET’s world shapefile. 

  • Where applicable, administrative unit names are approved by FEWS NET’s local staff in the country of interest. 

  • The standardized data are published and stored in the FEWS NET Data Warehouse (FDW). 

The process involves four sequential sub-processes, outlined below and in the supporting documentation. 

  1. Perform desk research on possible new boundary data or boundary updates. 

  2. Document potential changes in boundaries and administrative unit names.

  3. Make updates to the shapefile:

    1. Edge-match geometries.

    2. Create new unique FEWS NET IDs (FNIDs).

    3. Standardize the attributes.

    4. Produce a readme with sourcing information.

  4. Upload the standardized shapefile to the FEWS NET Data Warehouse (FDW) and inform key stakeholders that the file has been updated.

Perform administrative boundary source review for country of interest

The administrative boundary source review verifies that we are using the best available administrative boundary shapefiles for the country. Use the following steps to perform your review:

  1. Research possible sources for administrative boundary data in that country. For example:

    1. Government websites (local census, statistics ministry)

    2. HDX search for “___Country___ - Subnational Administrative Boundaries”

    3. Wikipedia often has a good first look at the types of administrative boundaries and their history.  Search “Administrative divisions of ___country__” 

  2. Review how any of those boundary datasets differ from FEWS NET’s existing boundaries (if applicable) or from each other. 

    1. Check the number of units, level of units, authority of source, and how recently produced. Check if reported changes are incorporated into the dataset. 

  3. Come to a consensus with any relevant stakeholders on the preferred source of new boundaries based on precision, high-quality sourcing, and recency.

Create boundary and name change review document

The boundary and name change document captures the changes made between FEWS NET’s existing administrative boundary file and the new boundary file in a single location. Use the following steps to document the changes:

  1. Compare the FEWS NET shapefile with the shapefile from the external source, especially on the following aspects: 

    1. Admin levels, e.g., if the country has created a new level of admin boundaries or a lower level is now available.

    2. Admin names, e.g., spellings, aliases, names in their original language, and English names.

    3. Admin boundaries, e.g., boundary shapes and name updates.

  2. Consolidate findings in a Google Doc to document changes over time, and if applicable, share them with the Decision Support field team to confirm any major changes.

Update and validate country shapefiles and readme text file

Use the guidance below to clean, document, and zip the shapefiles to standardize the source data to align with FEWS NET standards.

The steps for cleaning the boundaries are generally explained below. This companion document provides step by step instructions using two possible methods - one manual and one using an ArcGIS model tool to edge match boundaries using step by step instructions. 

Before you begin, confirm that you have the latest version of the world shapefile by accessing the FDE Spatial topic page and searching ‘world.’ Ensure you have downloaded the latest version of the “GAUL Global Admin0 boundaries.”

  1. Edge-match boundaries to the world shapefile:

    1. Start by editing/geoprocessing the lowest level of administrative boundary in the new dataset.

    2. Make sure the projection is WGS 1984. 

    3. Note any unique IDs (i.e., objectid or PCODEs if from a UN-derived source for each level of admin), make sure to maintain those throughout editing and geoprocessing. 

    4. Identify any places where the new subnational boundary falls outside of the FEWS NET country boundary, and remove those areas. 

    5. Identify any gaps where the subnational boundary does not extend to the FEWS NET country boundary. Extend those areas to match the FEWS NET country boundary.

    6. Use the Dissolve tool to aggregate up to Admin 1 level, preserving relevant attributes and unique IDs. 

    7. The file naming convention for the output files (and associated files) should be <two-letter country code>_Admin<level>_<YYYY>. For example MZ_Admin1_2021.shp and MZ_Admin2_2021.shp.

  2. Create the following standard attribute fields in the cleaned file(s):

    1. FNID: 18 character text

    2. EFF_YEAR: Short integer

    3. COUNTRY: 2 character text

    4. ADMIN0: 50 character text

    5. ADMIN1: 50 character text 

    6. ADMIN2: 50 character text

    7. ADMIN3: 50 character text (if applicable)

    8. ADMIN4: 50 character text (if applicable)

    9. ALIASES: 250 character text 

    10. ADMIN#XX: 50 character text (use for the local language if applicable)

If including the local language, add a field for each admin level to include the name in the local language. For example, in a country with 3 admin levels that speaks French, add ADMIN0FR, ADMIN1FR, ADMIN2FR, ADMIN3FR. The number represents the admin level, and the last two characters are the 2-digit ISO code for the language.

  1. Populate the standard attribute fields as follows:

    1. FNID: See FEWS NET IDs for details on structuring FNIDs.

    2. EFF_YEAR: The year the source organization last updated the shapefiles.

    3. COUNTRY: ISO 2 Character Country Code

    4. ADMIN0: English name of the country

    5. ADMIN1: English Admin 1 name of the unit

    6. ADMIN2: English Admin 2 name of the unit

    7. ADMIN3: English Admin 3 name of the unit (If applicable)

    8. ADMIN4: English Admin 4 name of the unit (If applicable)

    9. ALIASES: List of alternate spellings of the English name of the unit, separated by tildes. For example ~Mane~Mayne~Main~West New Brunswick~. This list should come from the previous shapefile, any alternate spellings identified in the shapefile review, and a quick review of the GNS.  

    10. ADMIN#XX: If a country has French, Spanish, Portuguese, or Arabic as a national language, include names of subnational units in those languages in their respective fields. The data should be in previous versions of the shapefiles or in the source shapefiles. Work to find sources as needed. If other local languages are present in the source data, it is best practice to maintain those spellings. 

  2. Create a readme.txt file with the source and FEWS Net documentation:

    1. In the folder, right click → New → Text Document.

    2. Add the text from this template cc_admin_yyyy_readme (Admin Shapefile Documentation Readme) - Google Docs. Update all items in bold brackets and delete sections that are not relevant. 

  3. Review the geometries

    1. Use the following steps to review the outputs:

      1. Use the Union tool to combine the output subnational boundaries with the country boundary from FEWS NET’s modified GUAL global boundaries.

      2. Review the attribute table to find any instances where the output boundaries did not union with the GAUL boundary. These areas need to be removed as they fall outside the GAUL boundary.

      3. Next, find any areas where the GAUL boundary did not intersect the subnational boundaries. This may only be one feature. For a multipart feature, use the ‘Explode’ tool on the editor toolbar to split the feature into different features. These areas all need to be added to the subnational boundary to match the GAUL boundary. 

  4. Review the tables

    1. The GIS or Data Specialist’s leadership should review the tables as follows:

      1. Copy tables to a Google Sheet.

      2. Ensure no repeated FNIDs:

        1. Format -> Conditional formatting, selecting "Custom formula is," and entering =COUNTIF(A:A, A1)>1 (update the column reference).

      3. Review the attribute field names.

      4. Ensure no extra attributes are maintained.

      5. Review the attributes for any obvious errors (missing data, misspellings).

  5. Review the readme

    1. The GIS or Data Specialist’s leadership should copyedit the readme.

  6. Create a ZIP file

    1. Zip all shapefiles and the readme in a file named CountryCode_Admin_EFF_YEAR.zip (for example, MZ_Admin_2021.zip).

Upload new shapefiles to the FEWS NET Data Warehouse

Following the review process, the new administrative boundary data should be uploaded to the FEWS NET Data Warehouse.

Pre-upload steps

The pre-upload steps depend on whether you are updating an existing Geographic Unit Set. Follow the guidance for the scenario that applies to your upload:

If the previous admin boundaries exist in FDW and the permissions for the new version will be the same, you must add an End date to the previous Geographic Unit Set Version before uploading the new version. From the main FDW toolbar, go to Metadata Management > Spatial > Geographic Unit Set Versions.   Update the End date of the current Geographic Unit Set Version: Search for the country’s FEWS NET Admin Boundaries. Use the search bar and/or the right hand side filters. Click the record to open the Change geographic unit set version screen. Change the End date to December 31 of the year before the effective year of the new shapefile. This step must be completed before uploading the new boundaries. Click Save and continue editing. Verify that the End date has updated. Then click Save and return to the Geographic unit set versions search page. Proceed to the Add a new Geographic Unit Set Version section below.
You will need to create a new Source Document and Geographic Unit Set before uploading the administrative boundaries in the following scenarios: There is no previous version of the administrative boundaries in FDW The country has a previous version of the administrative boundaries in FDW, but the new version needs to be assigned different permissions (for example, the new boundaries are USG/FEWS NET only) Create a new Source Document for the country: From the main FDW toolbar, go to Metadata Management → Warehouse → Source documents. Click Add Source Document and complete the following fields: Source Organization: Choose FEWS NET. Source Document: Name the Source Document according to the naming convention “Famine Early Warning Systems Network (FEWS NET), __country___, Administrative Boundaries.” If the units are USG/FEWS NET Only, append “(USG/FEWS NET Only)” on the name. Country: Select the country. Document Type: Select FEWS NET administrative unit boundaries. Usage Policy: Select a usage policy for the Source Document to determine the permissions for who can see and download any data that is associated with that Source Document. The vast majority of administrative boundaries in the FDW are public. If the data should not be released publicly, be careful to ensure the usage policy is set correctly. See for more information. Schedule: Select Ad Hoc. Click Save. Create a new Geographic Unit Set: Go to Metadata Management > Spatial > Geographic Unit Set. Click Add Geographic Unit Set Complete the following fields: Name: Use Geographic Unit Set naming convention “Country__ FEWS NET Admin Boundaries.” Country: Select the country. Data Source Document: Select the Source Document you created under step 1. Select Save. Proceed to the Add a new Geographic Unit Set Version section below. You can also create a new Geographic Unit Set from the Add Geographic Unit Set Version screen. Click the plus button next to the Geographic Unit Set field to open a popup window where you can create the new Geographic Unit Set.

Add a new Geographic Unit Set Version

The pre-upload steps described above must be completed before adding a Geographic Unit Set Version to avoid upload errors.

  1. From the main FDW toolbar, go to Metadata Management > Spatial > Geographic Unit Set Versions.  

  2. Click Add Geographic Unit Set Version and complete the following fields:

    1. Geographic Unit Set: Search for the Geographic Unit Set in the dropdown.

    2. Start: Set the Start as Jan 1 of the effective year of the shapefile. 

    3. Description: Populate with the country-specific content added to the readme .txt that was produced for this set of shapefiles. 

    4. File: Use Choose File to browse to the zip file with the new boundaries.

    5. Metadata: Enter ISO 19139 Geographic Information Metadata XML (optional).

  3. Click Save and continue editing. The backend will run the checks that are described below in the FDW troubleshooting section. 

  4. If it runs successfully, click Save.

Troubleshoot administrative boundaries uploads

Use the following information to troubleshoot administrative boundaries uploads in FDW:

  • If the same FNID and full_name are in different rows, this will not cause an error. The row will match the existing unit by code and update it. Repeated rows with the same FNID will overwrite the same record.

  • If an FNID is paired with a different full_name, this will not cause an error unless full_name is duplicated. The importer will match to the unit using the FNID and update the full_name, name, aliases, attributes, geometry, etc. The last row takes precedence.

    • If a new full_name collides with another unit’s full_name in the same layer, an error will be raised.

  • If a full_name is paired with a different FNID, an error will be raised.

Review the uploaded boundaries

You can review the uploaded boundaries using the FEWS NET Data Explorer (FDE).

  1. Go to the Spatial topic page in FDE.

  2. Filter by the country and the admin unit type. Look for a new row with the correct Start date.

  3. Select the row and scroll down.

  4. Review the Table and Map tabs to ensure the data is correct.  

You can adjust the positioning of a Geographic Unit’s label or icon on maps by manually setting the point location. To set a different display location from the centroid:

  1. Go Spatial > Geographic Units in the FDW.

  2. Select the Geographic Unit from the table.

  3. From the change screen, select the Allow Override Display Location option.

  4. Edit the Display Longitude and Display Latitude.

  5. Select Save.

Once you have confirmed the boundaries are uploaded as expected, inform any stakeholders via email. 

See also

Geographic Unit Sets

Geographic Unit Boundaries and Definitions

Geographic Unit Set Versions: Administrative and Crop Production