location

iati-activities/iati-activity/location

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

Definition

The sub-national geographical identification of the target locations of an activity. These can be described by gazetteer reference, coordinates, administrative areas or a textual description. Any number of locations may be reported.

Rules

This element may occur any number of times.

Attributes

@ref

An internal reference that describes the location in the reporting organisation’s own system.

This value must be of type xsd:string.

Example Usage

Example location for an iati-activity.

This element is a parent for other child elements.
An example organisation @ref of AF-KAN is declared.
<location ref="AF-KAN">
...
</location>
Full example with all child elements:
  <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>
The location element can be repeated in any iati-activity.

Changelog

2.01

The following child elements were removed: coordinates; gazetteer-entry; location-type.

The @percentage attribute was removed.

1.04

Note that major changes were made to the subelements of location in version 1.04.

For more information refer to:
The @ref attribute was introduced to provide a cross reference that a publisher can use to link back to their own internal system.
The @percentage attribute was deemed unworkable and deprecated in 1.04

1.03

Where used, the @percentage attribute is now designated as a decimal value and no longer as a positive Integer

Developer tools

Find the source of this documentation on github: