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


A unique code describing the location according to a recognised gazetteer or administrative boundary repository. Administrative areas should only be reported here if the location being defined is the administrative area itself. For describing the administrative area/s within which a more specific location falls the location/administrative element should be used.



A code from the gazetteer or administrative boundary repository specified by the vocabulary

This value must be of type xsd:string.


A code for a recognised gazetteer or administrative boundary respository.

This value must be of type xsd:string.

This value must be on the GeographicVocabulary codelist.

Example Usage

Example usage of location-id within context of location.

This example declares a GeographicVocabulary code G1 (Geonames) and a relevant code from that vocabulary:
  <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>
   <exactness code="1"/>
   <location-reach code="1" />
   <location-class code="2"/>
   <feature-designation code="PRNQ"/>

If the G2 vocabulary (Open Street Map) is used the code value should be of the form <OSM element>/<OSM identifier>

The OSM element will be a node, way or relation. Examples:

  • node/1234567
  • way/1234567
  • relation/1234567
<location-id vocabulary="G2" code="node/25524229" />



New in 1.04
The location-id element was introduced in 1.04 to replace the gazetteer-entry element which was deprecated in 1.04

Developer tools

Find the source of this documentation on github: