Geocoder API Developer's Guide

Response Examples

Example Geocode Response

For explanations of each element in the XML response, see Search Response

<Response>
  <MetaInfo>
    <Timestamp>2015-09-15T06:10:48.562Z</Timestamp>
  </MetaInfo>
  <View xsi:type="ns2:SearchResultsViewType">
    <ViewId>0</ViewId>
    <Result>
      <Relevance>1.0</Relevance>
      <MatchLevel>houseNumber</MatchLevel>
      <MatchQuality>
        <City>1.0</City>
        <Street>1.0</Street>
        <HouseNumber>1.0</HouseNumber>
      </MatchQuality>
      <MatchType>pointAddress</MatchType>
      <Location>
        <LocationId>NT_Opil2LPZVRLZjlWNLJQuWB_0ITN</LocationId>
        <LocationType>address</LocationType>
        <DisplayPosition>
          <Latitude>41.8843193</Latitude>
          <Longitude>-87.6387711</Longitude>
        </DisplayPosition>
        <NavigationPosition>
          <Latitude>41.884491</Latitude>
          <Longitude>-87.6387711</Longitude>
        </NavigationPosition>
        <MapView>
          <TopLeft>
            <Latitude>41.8854435</Latitude>
            <Longitude>-87.640281</Longitude>
          </TopLeft>
          <BottomRight>
            <Latitude>41.8831952</Latitude>
            <Longitude>-87.6372611</Longitude>
          </BottomRight>
        </MapView>
        <Address>
          <Label>
            425 W Randolph St, Chicago, 
            IL 60606, United States
          </Label>
          <Country>USA</Country>
          <State>IL</State>
          <County>Cook</County>
          <City>Chicago</City>
          <District>West Loop</District>
          <Street>W Randolph St</Street>
          <HouseNumber>425</HouseNumber>
          <PostalCode>60606</PostalCode>
          <AdditionalData key="CountryName">United States</AdditionalData>
          <AdditionalData key="StateName">Illinois</AdditionalData>
          <AdditionalData key="CountyName">Cook</AdditionalData>
          <AdditionalData key="PostalCodeType">N</AdditionalData>
        </Address>
      </Location>
    </Result>
  </View>
</Response>

Example Reverse Geocode Response

For explanations of each element in the XML response, see Search Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:Search xmlns:ns2="http://www.navteq.com/lbsp/Search-Search/4">
  <Response>
    <MetaInfo>
      <Timestamp>2015-09-15T06:34:14.645Z</Timestamp>
      <NextPageInformation>2</NextPageInformation>
    </MetaInfo>
    <View xsi:type="ns2:SearchResultsViewType">
      <ViewId>0</ViewId>
      <Result>
        <Relevance>1.0</Relevance>
        <Distance>0.7</Distance>
        <MatchLevel>houseNumber</MatchLevel>
        <MatchQuality>
          <Country>1.0</Country>
          <State>1.0</State>
          <County>1.0</County>
          <City>1.0</City>
          <District>1.0</District>
          <Street>1.0</Street>
          <HouseNumber>1.0</HouseNumber>
          <PostalCode>1.0</PostalCode>
        </MatchQuality>
        <MatchType>pointAddress</MatchType>
        <Location>
          <LocationId>NT_OV3A4F7PVZMW36XQixpFiB_zAD</LocationId>
          <LocationType>address</LocationType>
          <DisplayPosition>
            <Latitude>50.1123</Latitude>
            <Longitude>8.68285</Longitude>
          </DisplayPosition>
          <NavigationPosition>
            <Latitude>50.112</Latitude>
            <Longitude>8.68301</Longitude>
          </NavigationPosition>
          <MapView>
            <TopLeft>
              <Latitude>50.1134242</Latitude>
              <Longitude>8.681097</Longitude>
            </TopLeft>
            <BottomRight>
              <Latitude>50.1111758</Latitude>
              <Longitude>8.684603</Longitude>
            </BottomRight>
          </MapView>
          <Address>
            <Label>Berliner Straße 30, 60311 Frankfurt am Main, Deutschland</Label>
            <Country>DEU</Country>
            <State>Hessen</State>
            <County>Frankfurt am Main</County>
            <City>Frankfurt am Main</City>
            <District>Altstadt</District>
            <Street>Berliner Straße</Street>
            <HouseNumber>30</HouseNumber>
            <PostalCode>60311</PostalCode>
            <AdditionalData key="CountryName">Deutschland</AdditionalData>
            <AdditionalData key="StateName">Hessen</AdditionalData>
            <AdditionalData key="CountyName">Frankfurt am Main</AdditionalData>
          </Address>
          <MapReference>
            <ReferenceId>52308768</ReferenceId>
            <MapId>UWAM15124</MapId>
            <MapVersion>Q1/2015</MapVersion>
            <Spot>0.86</Spot>
            <SideOfStreet>left</SideOfStreet>
            <CountryId>20147700</CountryId>
            <StateId>20160993</StateId>
            <CountyId>20161002</CountyId>
            <CityId>20161003</CityId>
            <DistrictId>20299860</DistrictId>
            <AddressId>168611036</AddressId>
          </MapReference>
        </Location>
      </Result>
    </View>
  </Response>
</ns2:Search>

Example Multi Reverse Response

For explanations of each element in the XML response, see Multi Reverse Geocode Response

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<ns2:MultiSearch>
  <Response>
    <MetaInfo>
      <Timestamp>2015-09-15T06:34:14.645Z</Timestamp>
    </MetaInfo>
    <Item>
      <ItemId>1</ItemId>
      <Result>
        <Relevance>1.0</Relevance>
        <Distance>0.1</Distance>
        <MatchLevel>houseNumber</MatchLevel>
        <MatchQuality>
          <Country>1.0</Country>
          <State>1.0</State>
          <County>1.0</County>
          <City>1.0</City>
          <District>1.0</District>
          <Street>1.0</Street>
          <HouseNumber>1.0</HouseNumber>
          <PostalCode>1.0</PostalCode>
        </MatchQuality>
        <MatchType>pointAddress</MatchType>
        <Location>
        <LocationId>NT_5v-U9-t5AZa5VsRdV06lLB_xEjN</LocationId>
        <LocationType>address</LocationType>
          <DisplayPosition>
            <Latitude>52.53086</Latitude>
            <Longitude>13.38469</Longitude>
          </DisplayPosition>
          <NavigationPosition>
            <Latitude>52.53098</Latitude>
            <Longitude>13.38458</Longitude>
          </NavigationPosition>
          <MapView>
            <TopLeft>
              <Latitude>52.5319842</Latitude>
              <Longitude>13.3828421</Longitude>
            </TopLeft>
            <BottomRight>
              <Latitude>52.5297358</Latitude>
              <Longitude>13.3865379</Longitude>
            </BottomRight>
          </MapView>
          <Address>
            <Label>Invalidenstraße 116, 10115 Berlin, Deutschland</Label>
            <Country>DEU</Country>
            <State>Berlin</State>
            <County>Berlin</County>
            <City>Berlin</City>
            <District>Mitte</District>
            <Street>Invalidenstraße</Street>
            <HouseNumber>116</HouseNumber>
            <PostalCode>10115</PostalCode>
            <AdditionalData key="CountryName">Deutschland</AdditionalData>
            <AdditionalData key="StateName">Berlin</AdditionalData>
            <AdditionalData key="CountyName">Berlin</AdditionalData>
          </Address>
        </Location>
      </Result>
    </Item>
    <Item>
      <ItemId>2</ItemId>
      <Result>
      ...
      </Result>
    </Item>
    ...
  </Response>
</ns2:MultiSearch>
          

Example Landmark Geocode Response

For explanations of each element in the XML response, see Search Response

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<ns2:Search xmlns:ns2="http://www.navteq.com/lbsp/Search-Search/4">
  <Response>
    <MetaInfo>
      <Timestamp>2015-09-15T06:31:18.202Z</Timestamp>
    </MetaInfo>
    <View xsi:type="ns2:SearchResultsViewType">
      <ViewId>0</ViewId>
      <Result>
        <Relevance>1.0</Relevance>
        <MatchLevel>landmark</MatchLevel>
        <MatchQuality>
          <Name>1.0</Name>
        </MatchQuality>
        <Location>
          <LocationId>NT_AIzytxewh0cMjfGkhX4O.B</LocationId>
          <LocationType>historicalMonument</LocationType>
          <Name>Tour Eiffel</Name>
          <DisplayPosition>
            <Latitude>48.85824</Latitude>
            <Longitude>2.2945</Longitude>
          </DisplayPosition>
          <NavigationPosition>
            <Latitude>48.85863</Latitude>
            <Longitude>2.29397</Longitude>
          </NavigationPosition>
          <MapView>
            <TopLeft>
              <Latitude>48.87173</Latitude>
              <Longitude>2.274</Longitude>
            </TopLeft>
            <BottomRight>
              <Latitude>48.84475</Latitude>
              <Longitude>2.315</Longitude>
            </BottomRight>
          </MapView>
          <Address>
            <Label>75007 Paris, France</Label>
            <Country>FRA</Country>
            <State>Île-de-France</State>
            <County>Paris</County>
            <City>Paris</City>
            <District>7e Arrondissement</District>
            <PostalCode>75007</PostalCode>
            <AdditionalData key="CountryName">France</AdditionalData>
            <AdditionalData key="StateName">Île-de-France</AdditionalData>
      <AdditionalData key="CountyName">Paris</AdditionalData>
           </Address>
        </Location>
      </Result>
    </View>
  </Response>
</ns2:Search>