GeocodeAddressUSA - Spectrum_OnDemand - Latest

Spectrum OnDemand Web Services (REST)

Product type
Software
Portfolio
Verify
Product family
Spectrum
Product
Spectrum > Quality > Context Graph
Spectrum > Spatial > Spectrum Spatial Analyst
Spectrum > Spectrum Platform
Spectrum > Quality > Addressing
Spectrum > Quality > Spectrum Quality
Spectrum > Web Services
Spectrum > Dataflow Designer
Spectrum > Discovery
Spectrum OnDemand
Spectrum > Spatial > Spectrum Spatial Insights
Spectrum > Spatial > Spectrum Spatial
Spectrum > Geocoding > Enterprise Tax
Version
Latest
Language
English
Product name
Spectrum OnDemand
Title
Spectrum OnDemand Web Services (REST)
Copyright
2024
First publish date
2006
ft:lastEdition
2024-07-17
ft:lastPublication
2024-07-17T23:23:16.481321

GeocodeAddressUSA takes an address and returns latitude/longitude coordinates. GeocodeAddressUSA also standardizes and validates addresses using data from the U.S. Postal Service.

GeocodeAddressUSA can also geocode intersections. Instead of entering a mailing address, you can enter and intersection such as "Pearl St. and 28th" and obtain the coordinates of the intersection.

GeocodeAddressUSA is part of Enterprise Geocoding. For more information, see ee Enterprise Geocoding.

GeocodeAddressUSA takes an address as input. All addresses use this format regardless of the address's country. See Address Line Processing for U.S. Addresses for important information about how address line data is processed for U.S. addresses.

Resource URL

JSON endpoint:

https://OnDemandServer/rest/GeocodeAddressUSA/results.json

XML endpoint:

https://OnDemandServer/rest/GeocodeAddressUSA/results.xml

For a list of Spectrum OnDemand servers, see Connecting to Spectrum OnDemand Servers.

Example with JSON Response

This example requests a JSON response:

https://spectrum.precisely.com/rest/GeocodeAddressUS/results.json?Data.AddressLine1=3001+Summer+St&Data.City=Stamford&Data.StateProvince=CT

The JSON returned by this request would be:

{"Output": [{
   "Confidence": "89",
   "ProcessedBy": "KGL",
   "StreetDataType": "TOMTOM",
   "LocationCode": "AS0",
   "MatchCode": "S90",
   "AdditionalInputData": "",
   "AddressLine1": "3001 Summer St",
   "AddressLine2": "",
   "City": "Stamford",
   "Country": "United States of America",
   "FirmName": "",
   "LastLine": "Stamford, CT  06905-4317",
   "PostalCode": "06905-4317",
   "PostalCode.Base": "06905",
   "PostalCode.AddOn": "4317",
   "RRHC": "",
   "StateProvince": "CT",
   "USUrbanName": "",
   "PBKey": "",
   "Latitude": "41.071144",
   "Longitude": "-73.549149",
   "StreetSide": "R",
   "BlockLine1": "",
   "BlockLine2": "",
   "BlockLine3": "",
   "BlockLine4": "",
   "BlockLine5": "",
   "BlockLine6": "",
   "BlockSuffix": "",
   "CBSACode": "14860",
   "CBSADivisionCode": "",
   "CBSAMetro": "Y",
   "CensusBlockID": "090010212002007",
   "CensusTract": "021200",
   "CSACode": "408",
   "USFIPSCountyNumber": "001",
   "USFIPSStateCode": "09",
   "USFIPSStateCountyCode": "09001",
   "GeoConfidenceCentroidLatitude": "41.071144",
   "GeoConfidenceCentroidLongitude": "-73.549149",
   "GeoConfidenceCode": "ADDRESS",
   "StreetSegmentPoints": [{"SegmentPoints":    [
            {
         "Latitude": "41.071117",
         "Longitude": "-73.549338"
      },
            {
         "Latitude": "41.071204",
         "Longitude": "-73.549323"
      }
   ]}],
   "ApartmentLabel": "",
   "ApartmentLabel2": "",
   "ApartmentNumber": "",
   "ApartmentNumber2": "",
   "CrossStreetLeadingDirectional": "",
   "CrossStreetName": "",
   "CrossStreetSuffix": "",
   "CrossStreetTrailingDirectional": "",
   "HouseNumber": "3001",
   "LeadingDirectional": "",
   "PrivateMailbox": "",
   "PrivateMailbox.Designator": "",
   "StreetName": "Summer",
   "StreetSuffix": "St",
   "TrailingDirectional": "",
   "CityPreferredName": "Stamford",
   "CityStateRecordName": "Stamford",
   "CityShortName": "Stamford",
   "DeliveryPointCode": "99",
   "GovernmentBuilding": "",
   "PostalBarCode": "431799",
   "PostalCodeClass": "",
   "PostalCodeUnique": "",
   "PostalFacility": "P",
   "USBCCheckDigit": "7",
   "USCarrierRouteCode": "C006",
   "USCarrierRouteSort": "B",
   "USCityDelivery": "Y",
   "USLOTCode": "0054A",
   "AddressLineResolved": "",
   "CountryLevel": "A",
   "EWSMatch": "",
   "GeoStanMatchScore": "0.0000000",
   "Geocoder.MatchCode": "S5HPNTSC-A",
   "Intersection": "F",
   "IsAlias": "N01",
   "IsCloseMatch": "Y",
   "LACSAddress": "",
   "RecordType": "HighRise",
   "RecordType.Default": "Y",
   "DatabaseVersion": "May 2022",
   "ExpirationDate": "09/27/2022",
   "StreetDataCode": "2",
   "Alternate": "B",
   "HouseNumberHigh": "3001",
   "HouseNumberLow": "3001",
   "HouseNumberParity": "O",
   "PostalCodeExtensionHigh": "4317",
   "PostalCodeExtensionLow": "4317",
   "UnitNumberHigh": "",
   "UnitNumberLow": "",
   "UnitNumberParity": "",
   "BlockLeft": "090010213003001",
   "BlockRight": "090010212002007",
   "BlockSuffixLeft": "",
   "BlockSuffixRight": "",
   "RoadClass": "00",
   "SegmentCode": "244405",
   "SegmentDirection": "F",
   "SegmentHouseNumberHigh": "3001",
   "SegmentHouseNumberLow": "2984",
   "SegmentLength": "",
   "SegmentParity": "R",
   "PointCode": "",
   "Status": "",
   "Status.Code": "",
   "Status.Description": "",
   "HouseNumber2": "",
   "PreciselyId": "",
   "Block2010": "090010212002010",
   "user_fields": []
}]}

  

Example with XML Response

This example requests an XML response:

https://spectrum.precisely.com/rest/GeocodeAddressUSA/results.xml?Data.AddressLine1=3001+Summer+St&Data.City=Stamford&Data.StateProvince=CT
The XML returned by this request would be:
<xml.GeocodeAddressUSAResponse xmlns="http://www.pb.com/spectrum/services/GeocodeAddressUSA">
   <Output>
      <Address>
         <Confidence>89</Confidence>
         <ProcessedBy>KGL</ProcessedBy>
         <StreetDataType>TOMTOM</StreetDataType>
         <LocationCode>AS0</LocationCode>
         <MatchCode>S90</MatchCode>
         <AdditionalInputData/>
         <AddressLine1>3001 Summer St</AddressLine1>
         <AddressLine2/>
         <City>Stamford</City>
         <Country>United States of America</Country>
         <FirmName/>
         <LastLine>Stamford, CT  06905-4317</LastLine>
         <PostalCode>06905-4317</PostalCode>
         <PostalCode.Base>06905</PostalCode.Base>
         <PostalCode.AddOn>4317</PostalCode.AddOn>
         <RRHC/>
         <StateProvince>CT</StateProvince>
         <USUrbanName/>
         <PBKey/>
         <Latitude>41.071144</Latitude>
         <Longitude>-73.549149</Longitude>
         <StreetSide>R</StreetSide>
         <BlockLine1/>
         <BlockLine2/>
         <BlockLine3/>
         <BlockLine4/>
         <BlockLine5/>
         <BlockLine6/>
         <BlockSuffix/>
         <CBSACode>14860</CBSACode>
         <CBSADivisionCode/>
         <CBSAMetro>Y</CBSAMetro>
         <CensusBlockID>090010212002007</CensusBlockID>
         <CensusTract>021200</CensusTract>
         <CSACode>408</CSACode>
         <USFIPSCountyNumber>001</USFIPSCountyNumber>
         <USFIPSStateCode>09</USFIPSStateCode>
         <USFIPSStateCountyCode>09001</USFIPSStateCountyCode>
         <GeoConfidenceCentroidLatitude>41.071144</GeoConfidenceCentroidLatitude>
         <GeoConfidenceCentroidLongitude>-73.549149</GeoConfidenceCentroidLongitude>
         <GeoConfidenceCode>ADDRESS</GeoConfidenceCode>
         <StreetSegmentPoints>
            <StreetSegments>
               <SegmentPoints>
                  <SegmentPoint>
                     <Latitude>41.071117</Latitude>
                     <Longitude>-73.549338</Longitude>
                  </SegmentPoint>
                  <SegmentPoint>
                     <Latitude>41.071204</Latitude>
                     <Longitude>-73.549323</Longitude>
                  </SegmentPoint>
               </SegmentPoints>
            </StreetSegments>
         </StreetSegmentPoints>
         <ApartmentLabel/>
         <ApartmentLabel2/>
         <ApartmentNumber/>
         <ApartmentNumber2/>
         <CrossStreetLeadingDirectional/>
         <CrossStreetName/>
         <CrossStreetSuffix/>
         <CrossStreetTrailingDirectional/>
         <HouseNumber>3001</HouseNumber>
         <LeadingDirectional/>
         <PrivateMailbox/>
         <PrivateMailbox.Designator/>
         <StreetName>Summer</StreetName>
         <StreetSuffix>St</StreetSuffix>
         <TrailingDirectional/>
         <CityPreferredName>Stamford</CityPreferredName>
         <CityStateRecordName>Stamford</CityStateRecordName>
         <CityShortName>Stamford</CityShortName>
         <DeliveryPointCode>99</DeliveryPointCode>
         <GovernmentBuilding/>
         <PostalBarCode>431799</PostalBarCode>
         <PostalCodeClass/>
         <PostalCodeUnique/>
         <PostalFacility>P</PostalFacility>
         <USBCCheckDigit>7</USBCCheckDigit>
         <USCarrierRouteCode>C006</USCarrierRouteCode>
         <USCarrierRouteSort>B</USCarrierRouteSort>
         <USCityDelivery>Y</USCityDelivery>
         <USLOTCode>0054A</USLOTCode>
         <AddressLineResolved/>
         <CountryLevel>A</CountryLevel>
         <EWSMatch/>
         <GeoStanMatchScore>0.0000000</GeoStanMatchScore>
         <Geocoder.MatchCode>S5HPNTSC-A</Geocoder.MatchCode>
         <Intersection>F</Intersection>
         <IsAlias>N01</IsAlias>
         <IsCloseMatch>Y</IsCloseMatch>
         <LACSAddress/>
         <RecordType>HighRise</RecordType>
         <RecordType.Default>Y</RecordType.Default>
         <DatabaseVersion>May 2022</DatabaseVersion>
         <ExpirationDate>09/27/2022</ExpirationDate>
         <StreetDataCode>2</StreetDataCode>
         <Alternate>B</Alternate>
         <HouseNumberHigh>3001</HouseNumberHigh>
         <HouseNumberLow>3001</HouseNumberLow>
         <HouseNumberParity>O</HouseNumberParity>
         <PostalCodeExtensionHigh>4317</PostalCodeExtensionHigh>
         <PostalCodeExtensionLow>4317</PostalCodeExtensionLow>
         <UnitNumberHigh/>
         <UnitNumberLow/>
         <UnitNumberParity/>
         <BlockLeft>090010213003001</BlockLeft>
         <BlockRight>090010212002007</BlockRight>
         <BlockSuffixLeft/>
         <BlockSuffixRight/>
         <RoadClass>00</RoadClass>
         <SegmentCode>244405</SegmentCode>
         <SegmentDirection>F</SegmentDirection>
         <SegmentHouseNumberHigh>3001</SegmentHouseNumberHigh>
         <SegmentHouseNumberLow>2984</SegmentHouseNumberLow>
         <SegmentLength/>
         <SegmentParity>R</SegmentParity>
         <PointCode/>
         <Status/>
         <Status.Code/>
         <Status.Description/>
         <HouseNumber2/>
         <PreciselyId/>
         <Block2010>090010212002010</Block2010>
         <user_fields/>
      </Address>
   </Output>
</xml.GeocodeAddressUSAResponse>