NIEM Examples - Location Lookup (GLQ/GLR)
Location Lookup NIEM Specifications
This section provides NIEM format and examples for Location Lookup Transactions (GLQ/GLR).
All Nlets NIEM messages must be based on the Nlets NIEM Message Structure and include the standard Nlets XML Header as detailed in Message Structure. The NIEM header and hierarchy of the elements in this section are omitted to avoid redundancy. Consult the associated schemas and instances to determine the correct XPaths of the elements.
Element Dictionary
Transaction types detailed below include: General Location Query (GLQ) and General Location Response (GLR).
Query Formats
General Location Query (GLQ)
Inquiry Data (n2:NLETSInquiryData)
This element will contain all elements specific to this transaction.
Location Lookup (n2c:LocationLookup)
Information to specify the location of an object or entity..
Activity Identification (nc:ActivityIdentification)
NIEM: An identification that references an activity.
Identification ID (nc:IdentificationID)
NIEM: An identifier (in the context of Location Lookup, an incident identification).
Address (nc:PhysicalAddress)
NIEM: A physical address for a location. This may or may not be the same as the location's mailing address.
Address Full Text (nc:AddressFullText)
NIEM: A complete address.
Street (nc:AddressStreet)
NIEM: A road, thoroughfare, or highway.
City (nc:AddressCityName)
NIEM: A name of city or town.
State (nc:AddressState)
NIEM: A state, commonwealth, province, or other such geopolitical subdivision of a country.
ZIP (nc:AddressPostalCode)
NIEM: An identifier of a post office- assigned zone for an address.
Geographical Coordinates (nc:Location2DGeospatialCoordinates)
NIEM: A location identified by a latitude and longitude.
Latitude (nc:GeographicCoordinateLatitude)
NIEM: A measurement of the angular distance between a point on the earth and the equator.
Latitude Value (nc:LatitudeDegreeValue)
NIEM: A value that specifies the degree of latitude between -90 and +90 inclusive.
Longitude (nc:GeographicCoordinateLongitude)
NIEM: A measurement of the angular distance between a point on the earth and the Prime Meridian.
Longitude Value (nc:LongitudeDegreeValue)
NIEM: A value that specifies the degree of longitude between -180 and +180 inclusive.
Response Formats
General Location Response (GLR)
Response Data (n2:NLETSResponseData)
All data relevant to the response message.
n2c:LocationResponse
This element will contain the URL and a description of the URL
nc:ElectronicAddress
This element will contain the URL from the Intrado service and a description of the URL
nc:URLID
This element will contain the URL from the Intrado service
nc:ElectronicAddressDescriptionText
This element will contain a brief description of the URL
Location Lookup NIEM Examples
Example 1: Query of a location by full address with mandatory IncidentID.
<n2:NLETS n2:version="4.00"
xmlns:n2="http://www.nlets.org/niem/1.0"
xmlns:n2c="http://www.nlets.org/niem/nlets-core/1.0"
xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0"
xmlns:nc="http://release.niem.gov/niem/niem-core/5.0/">
<n2:NLETSMessageHeader>
<nh2:MessageKeyCodeText>GLQ</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>AZNLETS49</nh2:OriginatingORIID>
<nh2:DestinationORIID>NL</nh2:DestinationORIID>
<nh2:DocumentControlFieldText>GLQBYADR01</nh2:DocumentControlFieldText>
</n2:NLETSMessageHeader>
<n2:NLETSInquiryData n2:key="GLQ">
<n2c:LocationLookup>
<nc:ActivityIdentification>
<nc:IdentificationID>INCIDENT01</nc:IdentificationID>
</nc:ActivityIdentification>
<nc:PhysicalAddress>
<nc:AddressFullText>1918 W WHISPERING WIND DR, PHOENIX, AZ, 85085</nc:AddressFullText>
</nc:PhysicalAddress>
</n2c:LocationLookup>
</n2:NLETSInquiryData>
</n2:NLETS>
Example 2: Response to query of a location by full address with mandatory IncidentID.
<n2:NLETS
xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0"
n2:version="4.00"
xmlns:n2c="http://www.nlets.org/niem/nlets-core/1.0"
xmlns:nc5="http://release.niem.gov/niem/niem-core/5.0/"
xmlns:struct_50="http://release.niem.gov/niem/structures/5.0/"
xmlns:n2="http://www.nlets.org/niem/1.0">
<n2:NLETSMessageHeader>
<nh2:MessageKeyCodeText>GLR</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>NL0000000</nh2:OriginatingORIID>
<nh2:DestinationORIID>AZNLETS49</nh2:DestinationORIID>
<nh2:DocumentControlFieldText><![CDATA[GLQBYADR01]]></nh2:DocumentControlFieldText>
</n2:NLETSMessageHeader>
<n2:NLETSInquiryData n2:key="GLQ">
<n2c:LocationLookup>
<nc5:ActivityIdentification>
<nc5:IdentificationID>INCIDENT001</nc5:IdentificationID>
</nc5:ActivityIdentification>
<nc5:PhysicalAddress>
<nc5:AddressFullText>1918 W WHISPERING WIND, PHOENIX, AZ, 85085</nc5:AddressFullText>
</nc5:PhysicalAddress>
</n2c:LocationLookup>
</n2:NLETSInquiryData>
<n2:NLETSResponseData n2:key="GLR">
<n2c:LocationResponse>
<nc5:ElectronicAddress>
<nc5:ElectronicAddressDescriptionText>Initiate Search Result, Short Web Link</nc5:ElectronicAddressDescriptionText>
<nc5:URLID>https://c91.io/63kmj?token=REDACTED</nc5:URLID>
</nc5:ElectronicAddress>
</n2c:LocationResponse>
</n2:NLETSResponseData>
</n2:NLETS>
Example 3: Query of a location by address street/city/state/ZIP with mandatory IncidentID.
<n2:NLETS n2:version="4.00"
xmlns:n2="http://www.nlets.org/niem/1.0"
xmlns:n2c="http://www.nlets.org/niem/nlets-core/1.0"
xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0"
xmlns:nc="http://release.niem.gov/niem/niem-core/5.0/">
<n2:NLETSMessageHeader>
<nh2:MessageKeyCodeText>GLQ</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>AZNLETS49</nh2:OriginatingORIID>
<nh2:DestinationORIID>NL</nh2:DestinationORIID>
<nh2:DocumentControlFieldText>GLQBYADR02</nh2:DocumentControlFieldText>
</n2:NLETSMessageHeader>
<n2:NLETSInquiryData n2:key="GLQ">
<n2c:LocationLookup>
<nc:ActivityIdentification>
<nc:IdentificationID>INCIDENT01</nc:IdentificationID>
</nc:ActivityIdentification>
<nc:PhysicalAddress>
<nc:AddressStreet>
<nc:StreetFullText>1918 W WHISPERING WIND</nc:StreetFullText>
</nc:AddressStreet>
<nc:AddressCityName>PHOENIX</nc:AddressCityName>
<nc:AddressState>
<nc:StateName>AZ</nc:StateName>
</nc:AddressState>
<nc:AddressPostalCode>85085</nc:AddressPostalCode>
</nc:PhysicalAddress>
</n2c:LocationLookup>
</n2:NLETSInquiryData>
</n2:NLETS>
Example 4: Response to query of a location by address street/city/state/ZIP with mandatory IncidentID.
<n2:NLETS
xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0"
n2:version="4.00"
xmlns:n2c="http://www.nlets.org/niem/nlets-core/1.0"
xmlns:nc5="http://release.niem.gov/niem/niem-core/5.0/"
xmlns:struct_50="http://release.niem.gov/niem/structures/5.0/"
xmlns:n2="http://www.nlets.org/niem/1.0">
<n2:NLETSMessageHeader>
<nh2:MessageKeyCodeText>GLR</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>NL0000000</nh2:OriginatingORIID>
<nh2:DestinationORIID>AZNLETS49</nh2:DestinationORIID>
<nh2:DocumentControlFieldText><![CDATA[GLQBYADR02]]></nh2:DocumentControlFieldText>
</n2:NLETSMessageHeader>
<n2:NLETSInquiryData n2:key="GLQ">
<n2c:LocationLookup>
<nc5:ActivityIdentification>
<nc5:IdentificationID>INCIDENT001</nc5:IdentificationID>
</nc5:ActivityIdentification>
<nc5:PhysicalAddress>
<nc5:AddressStreet>
<nc5:StreetFullText>1918 W WHISPERING WIND</nc5:StreetFullText>
</nc5:AddressStreet>
<nc5:AddressCityName>PHOENIX</nc5:AddressCityName>
<nc5:AddressState>
<nc5:StateName>AZ</nc5:StateName>
</nc5:AddressState>
<nc5:AddressPostalCode>85085</nc5:AddressPostalCode>
</nc5:PhysicalAddress>
</n2c:LocationLookup>
</n2:NLETSInquiryData>
<n2:NLETSResponseData n2:key="GLR">
<n2c:LocationResponse>
<nc5:ElectronicAddress>
<nc5:ElectronicAddressDescriptionText>Initiate Search Result, Short Web Link</nc5:ElectronicAddressDescriptionText>
<nc5:URLID>https://c91.io/63kmj?token=REDACTED</nc5:URLID>
</nc5:ElectronicAddress>
</n2c:LocationResponse>
</n2:NLETSResponseData>
</n2:NLETS>
Example 5: Query of a location by latitude and longitude with mandatory IncidentID.
<n2:NLETS n2:version="4.00"
xmlns:n2="http://www.nlets.org/niem/1.0"
xmlns:n2c="http://www.nlets.org/niem/nlets-core/1.0"
xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0"
xmlns:nc="http://release.niem.gov/niem/niem-core/5.0/">
<n2:NLETSMessageHeader>
<nh2:MessageKeyCodeText>GLQ</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>AZNLETS49</nh2:OriginatingORIID>
<nh2:DestinationORIID>NL</nh2:DestinationORIID>
<nh2:DocumentControlFieldText>GLQBYGEO01</nh2:DocumentControlFieldText>
</n2:NLETSMessageHeader>
<n2:NLETSInquiryData n2:key="GLQ">
<n2c:LocationLookup>
<nc:ActivityIdentification>
<nc:IdentificationID>INCIDENT01</nc:IdentificationID>
</nc:ActivityIdentification>
<nc:Location2DGeospatialCoordinate>
<nc:GeographicCoordinateLatitude>
<nc:LatitudeDegreeValue>33.448376</nc:LatitudeDegreeValue>
</nc:GeographicCoordinateLatitude>
<nc:GeographicCoordinateLongitude>
<nc:LongitudeDegreeValue>-112.074036</nc:LongitudeDegreeValue>
</nc:GeographicCoordinateLongitude>
</nc:Location2DGeospatialCoordinate>
</n2c:LocationLookup>
</n2:NLETSInquiryData>
</n2:NLETS>
Example 6: Response to a query of a location by latitude and longitude with mandatory IncidentID.
<n2:NLETS
xmlns:nh2="http://www.nlets.org/niem/nlets-hdr/1.0"
n2:version="4.00"
xmlns:n2c="http://www.nlets.org/niem/nlets-core/1.0"
xmlns:nc5="http://release.niem.gov/niem/niem-core/5.0/"
xmlns:struct_50="http://release.niem.gov/niem/structures/5.0/"
xmlns:n2="http://www.nlets.org/niem/1.0">
<n2:NLETSMessageHeader>
<nh2:MessageKeyCodeText>GLR</nh2:MessageKeyCodeText>
<nh2:OriginatingORIID>NL0000000</nh2:OriginatingORIID>
<nh2:DestinationORIID>AZNLETS49</nh2:DestinationORIID>
<nh2:DocumentControlFieldText><![CDATA[GLQBYGEO01]]></nh2:DocumentControlFieldText>
</n2:NLETSMessageHeader>
<n2:NLETSInquiryData n2:key="GLQ">
<n2c:LocationLookup>
<nc5:ActivityIdentification>
<nc5:IdentificationID>INCIDENT001</nc5:IdentificationID>
</nc5:ActivityIdentification>
<nc5:Location2DGeospatialCoordinate>
<nc5:GeographicCoordinateLatitude>
<nc5:LatitudeDegreeValue>32.1234</nc5:LatitudeDegreeValue>
</nc5:GeographicCoordinateLatitude>
<nc5:GeographicCoordinateLongitude>
<nc5:LongitudeDegreeValue>-112.1234</nc5:LongitudeDegreeValue>
</nc5:GeographicCoordinateLongitude>
</nc5:Location2DGeospatialCoordinate>
</n2c:LocationLookup>
</n2:NLETSInquiryData>
<n2:NLETSResponseData n2:key="GLR">
<n2c:LocationResponse>
<nc5:ElectronicAddress>
<nc5:ElectronicAddressDescriptionText>Initiate Search Result, Short Web Link</nc5:ElectronicAddressDescriptionText>
<nc5:URLID>https://c91.io/16vwv?token=REDACTED</nc5:URLID>
</nc5:ElectronicAddress>
</n2c:LocationResponse>
</n2:NLETSResponseData>
</n2:NLETS>