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
- f_idNonumberNo-For new locations, this column will be empty. For updates, KfW will provide you with the list of f_id numbers of this file to ensure that the updated field ids match with the former ones.
+ scheme_versionNoenum (of string)No--
+ donor_project_noNonumberNo-Every project location must be assigned to its respective BMZ project number.
+ project_acronymNostringNo-Enter the acronym used for the name/title of the project (e.g. HREII) to be visible on your map. If the project has multiple phases, please add the number of the phase belonging to the before-stated KfW Project-No.
+ 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.
+ date_of_data_collectionNoobjectNo-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.
+ 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 availabe. This will be used as reference for line and polygon data.
+ 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_dateNoobjectNo-Aprox. 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_dateNoobjectNo-Aprox. 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, see table sheets ‘Location Types’ & KC Themes. If there is no fit, select ‘_Generic/Crosssect.’ here and then ‘other physical/immaterial’ in the next column.
+ location_type_nameNoenum (of string)No-After selecting the KC Theme, choose the most appropriate location type, see table sheet ‘Location Types’. If there is no fit please select ‘other phys./imm.’
+ 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).’.

1. Property Project Location Model > f_id

Typenumber
RequiredNo

Description: For new locations, this column will be empty. For updates, KfW will provide you with the list of f_id numbers of this file to ensure that the updated field ids match with the former ones.

2. Property Project Location Model > scheme_version

Typeenum (of string)
RequiredYes

Must be one of:

  • “3.0”

3. Property Project Location Model > donor_project_no

Typenumber
RequiredYes

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

4. Property Project Location Model > project_acronym

Typestring
RequiredYes

Description: Enter the acronym used for the name/title of the project (e.g. HREII) to be visible on your map. If the project has multiple phases, please add the number of the phase belonging to the before-stated KfW Project-No.

5. Property Project Location Model > data_provider

Typestring
RequiredYes

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

6. 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”

7. Property Project Location Model > date_of_data_collection

Typeobject
RequiredYes
Additional propertiesAny type allowed

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.

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 availabe. This will be used as reference for line and polygon data.

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”
  • “Pipeline/identification”
  • “Implementation”
  • “Finalisation”
  • “Closed”
  • “Cancelled”
  • “Suspended”
  • “Other”

11. Property Project Location Model > activity_start_date

Typeobject
RequiredYes
Additional propertiesAny type allowed

Description: Aprox. 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

Typeobject
RequiredYes
Additional propertiesAny type allowed

Description: Aprox. 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, see table sheets ‘Location Types’ & KC Themes. If there is no fit, select ‘_Generic/Crosssect.’ here and then ‘other physical/immaterial’ in the next column.

Must be one of:

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

15. Property Project Location Model > location_type_name

Typeenum (of string)
RequiredYes

Description: After selecting the KC Theme, choose the most appropriate location type, see table sheet ‘Location Types’. If there is no fit please select ‘other phys./imm.’

Must be one of:

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

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)”

Generated using json-schema-for-humans on 2026-03-31 at 08:55:08 +0000