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.

Rules

This element may occur any number of times.

Attributes

@code

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

This attribute is required.

This value must be of type xsd:string.

@vocabulary

An IATI code for a recognised administrative boundary repository.

This attribute is required.

This value must be of type xsd:string.

This value must be on the GeographicVocabulary codelist.

@level

A number defining a subdivision within a hierarchical system of administrative areas. The precise system for defining the particular meaning of each @level value is determined by the @vocabulary being used.

This value must be of type xsd:nonNegativeInteger.

Example Usage

Example usage of administrative within a location of an iati-activity.

The @vocabulary attribute declares a valid code (G1) from the GeographicVocabulary codelist.
An example value of 1453782 from that vocabulary is declared in the @code attribute.
An example value of 1 is declared for the @level attribute.
  <location ref="AF-KAN">
   <location-reach code="1" />	  
   <location-id vocabulary="G1" code="1453782" />
   <name>
	<narrative>Location name</narrative>
   </name>
   <description>
	<narrative>Location description</narrative>
   </description>
   <activity-description>
	<narrative>A description that qualifies the activity taking place at the location</narrative>
   </activity-description>
   <administrative vocabulary="G1" level="1" code="1453782" />
   <point srsName="http://www.opengis.net/def/crs/EPSG/0/4326">
    <pos>31.616944 65.716944</pos>
   </point>
   <exactness code="1"/>
   <location-class code="2"/>
   <feature-designation code="ADMF"/>
  </location>

Note: Multiple administrative levels can be reported by repeating the administrative element:

<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="0" code="1149361" vocabulary="G1" />
   <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>

Changelog

2.01

Freetext is no longer allowed within this element.

The @county, @adm1 and @adm2 attributes were removed.

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:

Last updated on 2015-01-21