location¶

iati-activities/iati-activity/location

This is the reference page for the XML element location.

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:

<location ref="AF-KAN">
...
</location>
<location ref="KH-PNH">
...
</location>

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 1.04 location changes overview guidance
the Activities Schema Changelog (or the individual subemelement pages)

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: