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.jsonXML endpoint:
https://OnDemandServer/rest/GeocodeAddressUSA/results.xmlFor 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=CTThe 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=CTThe 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>