administrative

iati-activities/iati-activity/location/administrative

This is the reference page for the XML element administrative. See also the relevant overview page: Geography

Definition

Coded identification of national and sub-national divisions according to recognised administrative boundary repositories. Multiple levels may be reported.

Attributes

@code

The code for the administrative area being reported from the vocabulary specified.

This value must be of type xsd:string.

@vocabulary

The code for a recognised administrative boundary. repository

This value must be of type xsd:string.

This value must be on the GeographicVocabulary codelist.

@level

An integer indicating the hierarchical level being reported. Level 0 is the national boundary, level 1 is the first-level administrative sub-division, etc.

This value must be of type xsd:nonNegativeInteger.

@country

Deprecated since 1.04

The ISO 3166-1 alpha2 code for the country (e.g. “GB” for the United Kingdom).

For the @code attribute, see http://iatistandard.org/codelists/country

This value must be of type xsd:string.

This value should be on the Country codelist.

@adm1

Deprecated since 1.04

The UNSALB level-one administrative code for a subdivision of a country.

See http://iatistandard.org/codelists/admin1

This value must be of type xsd:string.

@adm2

Deprecated since 1.04

The UNSALB level-two administrative code for a subdivision of a country.

See http://iatistandard.org/codelists/admin2

This value must be of type xsd:string.

Example Usage

Example usage of administrative within context of location

This example declares a GeographicVocabulary code G1 (Geonames) and a relevant code from that vocabulary, alongside an appropriate level:
  <location ref="AF-KAN">
   <location-id vocabulary="G1" code="1453782" />
   <name>Location name</name>
   <description>Location description</description>
   <activity-description>A description that qualifies the activity taking place at the location</activity-description>
   <administrative level="1" code="1453782" vocabulary="G1" />
   <point srsName="http://www.opengis.net/def/crs/EPSG/0/4326">
    <pos>31.616944 65.716944</pos>
   </point>
   <exactness code="1"/>
   <location-reach code="1" />
   <location-class code="2"/>
   <feature-designation code="PRNQ"/>
  </location>

Prior to 1.04 National and sub-national administrative divisions could be declared as such (but as of 1.04 the @country, @adm1 and @adm2 attributes are deprecated):

<administrative country="AF" adm1="KAN">Kandahar Province, Afghanistan</administrative>

Changelog

1.04

In 1.04 the @country, @adm1 and @adm2 attributes were deprecated. The new attributes replace the function of the previous ones.

Developer tools

Find the source of this documentation on github: