Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Project Location Model

This document describes the JSON schema for project_core_schema_en.json.


Project Location Model

Title: Project Location Model

Typeobject
RequiredNo
Additional propertiesAny type allowed

Description: This schema defines the structure of the project location model. It is used to validate the project location data provided by the KfW counterpart.

PropertyPatternTypeDeprecatedDefinitionTitle/Description
+ scheme_versionNoenum (of string)No--
- fidNonumberNo-Unique identifier for each project location. This can be a local MIS-/GIS-ID or a combination of project number and location name.
+ date_of_data_collectionNostringNo-Date of data collection or latest update (if date of data collection is unknown). In case only the year is available please choose the 1st of january e.g. 2022-01-01.
+ donor_project_noNointegerNo-Every project location must be assigned to its respective BMZ project number.
+ project_acronymNostringNo-Enter the acronym used for easy identification of the project (e.g. HRE II).
+ data_providerNostringNo-Legal Entity who owns the data provided here (= legal authorship).
+ publishing_restrictionsNoenum (of string)No-Indicates if the exact location is collected in fragile areas (e.g. of severe civil conflict or war) and should therefore be omitted from publicly available reports.
+ related_communityNostringNo-Enter a community, village, hamlet or neighbourhood name that relates to this location, this can serve for manually add smaller administrative unit names that are not in global databases.
+ location_nameNostringNo-Unique name of the project site and its (main) activity incl. local MIS-/GIS-ID, if available.
+ location_activity_statusNoenum (of string)No-The location activity status according to the IATI standard. If you are unaware of the current status please choose ‘NA’.
+ activity_start_dateNostringNo-Approximate planned or actual start date of implementation of activities on the ground. This can be e.g. the date when construction work is planned to begin. For no information enter 2100-01-01.
+ activity_end_dateNostringNo-Approximate planned or actual end date of activities on the ground. This can be e.g. the date when the project is planned to cease implementation activities. For no information enter 2100-01-01.
+ activity_descriptionNostringNo-A short description of the main project activity in this location, e.g., hydropower plant construction or construction of small irrigation systems.
+ location_type_themeNoenum (of string)No-Sectoral / cross-sectoral location type preselection field. Choose from drop-down menu. If there is no fit, select ‘_Generic/Cross_sectoral’.
+ location_type_nameNoenum (of string)No-After selecting the Location Type Theme, choose the most appropriate Location Type Name from the drop-down menu. If there is no fit, select ‘_Generic/Cross_sect.’, and then ‘other physical’ or ‘other immaterial’.
+ geographic_exactnessNoenum (of string)No-Use ‘exact’ if the exact coordinates are known + no security restrictions apply. Otherwise, use ‘approximate (security)’ or ‘approx. (yet unknown)’. If the target area is an admin unit, use ‘approx. (admin unit).’.
- latitudeNonumberNo-Optional. Provide this value only when uploading coordinates via Excel
- longitudeNonumberNo-Optional. Provide this value only when uploading coordinates via Excel

1. Property Project Location Model > scheme_version

Typeenum (of string)
RequiredYes

Must be one of:

  • “4.0”

2. Property Project Location Model > fid

Typenumber
RequiredNo
Default-1

Description: Unique identifier for each project location. This can be a local MIS-/GIS-ID or a combination of project number and location name.

3. Property Project Location Model > date_of_data_collection

Typestring
RequiredYes
Formatdate

Description: Date of data collection or latest update (if date of data collection is unknown). In case only the year is available please choose the 1st of january e.g. 2022-01-01.

4. Property Project Location Model > donor_project_no

Typeinteger
RequiredYes

Description: Every project location must be assigned to its respective BMZ project number.

5. Property Project Location Model > project_acronym

Typestring
RequiredYes

Description: Enter the acronym used for easy identification of the project (e.g. HRE II).

6. Property Project Location Model > data_provider

Typestring
RequiredYes

Description: Legal Entity who owns the data provided here (= legal authorship).

7. Property Project Location Model > publishing_restrictions

Typeenum (of string)
RequiredYes

Description: Indicates if the exact location is collected in fragile areas (e.g. of severe civil conflict or war) and should therefore be omitted from publicly available reports.

Must be one of:

  • “yes”
  • “no”
Typestring
RequiredYes

Description: Enter a community, village, hamlet or neighbourhood name that relates to this location, this can serve for manually add smaller administrative unit names that are not in global databases.

9. Property Project Location Model > location_name

Typestring
RequiredYes

Description: Unique name of the project site and its (main) activity incl. local MIS-/GIS-ID, if available.

10. Property Project Location Model > location_activity_status

Typeenum (of string)
RequiredYes

Description: The location activity status according to the IATI standard. If you are unaware of the current status please choose ‘NA’.

Must be one of:

  • “NA”
  • “Cancelled”
  • “Closed”
  • “Finalisation”
  • “Implementation”
  • “Other”
  • “Pipeline/identification”
  • “Suspended”

11. Property Project Location Model > activity_start_date

Typestring
RequiredYes
Formatdate

Description: Approximate planned or actual start date of implementation of activities on the ground. This can be e.g. the date when construction work is planned to begin. For no information enter 2100-01-01.

12. Property Project Location Model > activity_end_date

Typestring
RequiredYes
Formatdate

Description: Approximate planned or actual end date of activities on the ground. This can be e.g. the date when the project is planned to cease implementation activities. For no information enter 2100-01-01.

13. Property Project Location Model > activity_description

Typestring
RequiredYes

Description: A short description of the main project activity in this location, e.g., hydropower plant construction or construction of small irrigation systems.

14. Property Project Location Model > location_type_theme

Typeenum (of string)
RequiredYes

Description: Sectoral / cross-sectoral location type preselection field. Choose from drop-down menu. If there is no fit, select ‘_Generic/Cross_sectoral’.

Must be one of:

  • “_Generic_Cross_Sectoral”
  • “Aquaculture_Fishery”
  • “Agriculture_Rural_Development”
  • “Biodiversity_Conservation”
  • “Education”
  • “Energy”
  • “Financial_Sector_Development”
  • “Governance_Decentralization”
  • “Health”
  • “Mobility_Transport”
  • “Peace_Displacement_Fragility”
  • “Protected_and_Conserved_Areas”
  • “Social_Protection”
  • “Urban_Infrastructure”
  • “Waste”
  • “Water_Management”

15. Property Project Location Model > location_type_name

Typeenum (of string)
RequiredYes

Description: After selecting the Location Type Theme, choose the most appropriate Location Type Name from the drop-down menu. If there is no fit, select ‘_Generic/Cross_sect.’, and then ‘other physical’ or ‘other immaterial’.

Must be one of:

  • “(communal) public infrastructure”
  • “(multimodal) logistic node / warehouse”
  • “(urban) street”
  • “advisory facility / support”
  • “agricultural extension services”
  • “agricultural plantations”
  • “agroforestry area”
  • “airplane(s)”
  • “airport”
  • “animal production (intensive)”
  • “aquaculture”
  • “area covered by off-grid renewable energy”
  • “area covered by on-grid renewable energy”
  • “aviation safety system / flight control”
  • “bank”
  • “banking branch / outlet”
  • “basic social services”
  • “battery energy storage system (BESS)”
  • “biodiversity offset / compensation area incl. PFES”
  • “biogas plant”
  • “boat(s) / ship(s) / -yard”
  • “bonds”
  • “bridge”
  • “building(s)”
  • “buffer zone around a protected or sensitive area”
  • “bus rapid transit (BRT) / bus system”
  • “bus station / terminal”
  • “buses”
  • “cadastre / land management / tenure system / area”
  • “camp(s)”
  • “capacity development / training”
  • “cash- / food-for-work”
  • “cash transfers”
  • “certified sustainable aquaculture or fisheries (MSC, ASC)”
  • “certified sustainable forest management (FSC, Rainforest Alliance, PEFC)”
  • “charging station”
  • “child protection services”
  • “citizen participation / feedback (system)”
  • “citizen service center”
  • “city district / urban development”
  • “civil society support”
  • “clinic”
  • “climate risk insurance”
  • “coastguard station”
  • “common / public space(s)”
  • “community policing”
  • “company”
  • “contract farming / PPP”
  • “credit guarantee fund”
  • “cultivated area”
  • “customs office”
  • “decentralisation support & communal development”
  • “democratization support”
  • “depot / marshalling yard”
  • “desalination plant”
  • “decentralized sanitation (area)”
  • “digital services usage area”
  • “digital transformation of public services”
  • “disarmament, demobilisation, reintegration of combatants (DDR)”
  • “dispensary”
  • “district heating area / distribution”
  • “distribution of medical products / contraceptives”
  • “domestic revenue mobilization”
  • “drinking water supply”
  • “drinking water treatment plant (without desalination)”
  • “early warning system”
  • “ecological corridor / connectivity area”
  • “electric power transmission & distribution (T&D)”
  • “electric substation”
  • “election support”
  • “emergency supplies distribution area”
  • “employment subsidies”
  • “energy efficiency measure(s)”
  • “environmental & social mgt system”
  • “equipment / materials”
  • “exclusive economic zone (EEZ)”
  • “facility”
  • “factory”
  • “FAO catch-area”
  • “farmers groups / cooperatives support”
  • “feed-mill”
  • “ferry (line, system)”
  • “financial institution”
  • “fire management area”
  • “fire station”
  • “fisheries management area”
  • “flood protection”
  • “food access point”
  • “food processing & value addition”
  • “free trade zone”
  • “fuel station”
  • “funds manager headquarters”
  • “garden(s)”
  • “geothermal power plant”
  • “grazing / rangeland (management) area”
  • “guarantees”
  • “habitat or species management area (IUCN Cat IV)”
  • “harvesting sites for NTFPs and other biodiversity products”
  • “hazardous waste treatment plant”
  • “health post”
  • “highway”
  • “hospital”
  • “housing (development)”
  • “hub / cluster / incubator”
  • “hydrogen plant”
  • “hydro-meteorological measurement system”
  • “hydropower plant / dam”
  • “ICT infrastructure (broadband / connectivity)”
  • “ICT infrastructure (data center)”
  • “ICT-infrastructure / ICT-equipment”
  • “improved soil / erosion control area”
  • “improved waste collection”
  • “income generating activities (IGA)”
  • “indigenous & community conservation area (ICCA)”
  • “indigenous and traditional territories (ITT)”
  • “indigenous peoples & local communities (IP&LC)”
  • “industrial area / zone”
  • “inland waters fishery”
  • “insurance (other)”
  • “intergovernmental fiscal transfer mechanism”
  • “interurban rail infrastructure”
  • “internally displaced persons (IDP) camp”
  • “intraurban rail infrastructure”
  • “invasive species management area”
  • “irrigated field(s)”
  • “irrigation infrastructure”
  • “key biodiversity area (KBA) with financed management”
  • “laboratory”
  • “landfill”
  • “landfill gas capture and treatment”
  • “loans”
  • “locally managed marine areas (LMMA)”
  • “marine protected area (MPA)”
  • “market (shopping area)”
  • “matching grants distribution area”
  • “mechanical-biological treatment plant”
  • “media support”
  • “medical isolation station”
  • “medical products development”
  • “micro, small & medium enterprises (MSME)”
  • “microfinance institution (MFI)”
  • “mine(s)”
  • “mining associated facilities”
  • “ministry”
  • “monitoring and research sites”
  • “museum”
  • “national park (IUCN Cat II)”
  • “natural monument or feature (IUCN Cat III)”
  • “no-take zone”
  • “nuclear power station”
  • “nursery(-ies) / seed bank”
  • “office building”
  • “oil and gas extraction (marine)”
  • “oil and gas extraction (terrestrial)”
  • “oil or gas power station”
  • “oil refinery”
  • “other effective area-based conservation measures (OECM)”
  • “other immaterial”
  • “other physical”
  • “other road-based vehicles”
  • “other waste treatment plants”
  • “parks & other green areas”
  • “pedestrian lane(s) / bike lane(s)”
  • “political / institutional reforms (PBF / PBL)”
  • “pond”
  • “port”
  • “power station (other)”
  • “private protected area / conservation easement”
  • “protected area with sustainable use of natural resources (IUCN Cat VI)”
  • “protected landscape or seascape (IUCN Cat V)”
  • “public (admin) training institute”
  • “public / social dialogue”
  • “public financial management (PFM)”
  • “quarrying”
  • “rail operation control system / intelligent transport system (ITS)”
  • “railroad”
  • “railroad station”
  • “ranger station / field base”
  • “re- / afforestation area”
  • “recycling facility”
  • “refugee camp”
  • “regeneration / restoration / rehabilitation area”
  • “rehabilitation / reconstruction”
  • “reparation payments”
  • “research institute / facility”
  • “reservoir(s)”
  • “road”
  • “rolling stock”
  • “sanitary facility”
  • “saving groups / VSLA / SACCOs support”
  • “scholarship program area”
  • “school (primary, secondary, college)”
  • “sensitization / awareness raising (campaign)”
  • “sewage treatment plant”
  • “sewer network”
  • “shopping center or mall”
  • “slaughterhouse”
  • “sludge treatment & disposal”
  • “slum upgrading”
  • “small scale fisheries (SSF) zone”
  • “social franchising / NGO clinics”
  • “social marketing”
  • “social protection system”
  • “solar power plant”
  • “stormwater network / system”
  • “strict nature reserve (IUCN Cat Ia)”
  • “street lighting”
  • “subordinated loans”
  • “supply chains (support) area”
  • “sustainably farmed area(s)”
  • “tidal / marine power station”
  • “traffic management center / IST”
  • “transfer station”
  • “TVET school / infrastructure”
  • “university”
  • “violence prevention”
  • “visitor center / education facility”
  • “voucher(s) (system) distribution area”
  • “waste-to-energy plant”
  • “water intake”
  • “water pipeline”
  • “water pump”
  • “water re-use”
  • “water resources protection area”
  • “water tank”
  • “watercourse”
  • “watershed / catchment conservation area”
  • “waterway(s) (system)”
  • “weir(s)”
  • “well”
  • “wilderness area (IUCN Cat Ib)”
  • “wildlife management area / game reserve”
  • “wind power plant”
  • “wind power plant (offshore)”
  • “wind power plant (onshore)”
  • “women’s shelter / GBV support”
  • “workshop(s)”

16. Property Project Location Model > geographic_exactness

Typeenum (of string)
RequiredYes

Description: Use ‘exact’ if the exact coordinates are known + no security restrictions apply. Otherwise, use ‘approximate (security)’ or ‘approx. (yet unknown)’. If the target area is an admin unit, use ‘approx. (admin unit).’.

Must be one of:

  • “exact”
  • “approximate (yet unknown)”
  • “approximate (security)”
  • “approximate (admin unit)”

17. Property Project Location Model > latitude

Typenumber
RequiredNo

Description: Optional. Provide this value only when uploading coordinates via Excel

Restrictions
Minimum≥ -90
Maximum≤ 90

18. Property Project Location Model > longitude

Typenumber
RequiredNo

Description: Optional. Provide this value only when uploading coordinates via Excel

Restrictions
Minimum≥ -180
Maximum≤ 180

Generated using json-schema-for-humans on 2026-09-17 at 07:57:29 +0000