Resource URL
JSON endpoint:
http://server:port/rest/GeocodeUSAddress/results.json
https://OnDemandServer/rest/GeocodeUSAddress/results.json
XML endpoint:
http://server:port/rest/GeocodeUSAddress/results.xml
https://OnDemandServer/rest/GeocodeUSAddress/results.xml
For a list of Spectrum OnDemand servers, see Connecting to Spectrum OnDemand Servers.
Example with JSON Response
The following example requests a JSON response:
http://myserver:8080/rest/GeocodeUSAddress/results.json?Data.AddressLine1=3001+Summer+St&Data.City=Stamford&Data.StateProvince=CT
https://spectrum.precisely.com/rest/GeocodeUSAddress/results.json?Data.AddressLine1=3001+Summer+St&Data.City=Stamford&Data.StateProvince=CT
The JSON returned by this request would be:
{"output_port": [{
"BlockSuffix": "",
"CBSADivisionCode": "",
"CBSAMetro": "Y",
"CBSACode": "14860",
"CensusBlockID": "090010212002010",
"USFIPSCountyNumber": "001",
"CSACode": "408",
"CensusTract": "021200",
"USFIPSStateCode": "09",
"USFIPSStateCountyCode": "09001",
"Latitude": "41.071067",
"Longitude": "-73.549161",
"StreetSide": "R",
"BlockLine1": "",
"BlockLine2": "",
"BlockLine3": "",
"BlockLine4": "",
"BlockLine5": "",
"BlockLine6": "",
"FirmName": "Stamford Square",
"AddressLine1": "3001 Summer St",
"AddressLine2": "",
"LastLine": "Stamford, CT 06905-4317",
"StreetName": "Summer",
"CrossStreetName": "",
"LeadingDirectional": "",
"CrossStreetLeadingDirectional": "",
"HouseNumber": "3001",
"HouseNumber2": "",
"TrailingDirectional": "",
"CrossStreetTrailingDirectional": "",
"StreetSuffix": "St",
"CrossStreetSuffix": "",
"ApartmentLabel": "",
"ApartmentLabel2": "",
"ApartmentNumber": "",
"ApartmentNumber2": "",
"AdditionalInputData": "",
"City": "Stamford",
"StateProvince": "CT",
"PostalCode.Base": "06905",
"PostalCode.AddOn": "4317",
"PostalCode": "06905-4317",
"PrivateMailbox.Designator": "",
"PrivateMailbox": "",
"USUrbanName": "",
"Country": "United States of America",
"RRHC": "",
"USCarrierRouteCode": "C006",
"USBCCheckDigit": "7",
"PostalBarCode": "431799",
"DeliveryPointCode": "99",
"GovernmentBuilding": "",
"USLOTCode": "0012A",
"USCarrierRouteSort": "B",
"USCityDelivery": "Y",
"PostalCodeClass": "",
"PostalFacility": "P",
"PostalCodeUnique": "",
"CityStateRecordName": "Stamford",
"CityPreferredName": "Stamford",
"CityShortName": "Stamford",
"DPV": "D",
"DPVFootnote": "AAN1",
"CMRA": "N",
"Alternate": "B",
"HouseNumberHigh": "3001",
"HouseNumberLow": "3001",
"HouseNumberParity": "O",
"UnitNumberHigh": "",
"UnitNumberLow": "",
"UnitNumberParity": "",
"PostalCodeExtensionHigh": "4317",
"PostalCodeExtensionLow": "4317",
"AddressLineResolved": "",
"EWSMatch": "",
"RecordType.Default": "Y",
"Intersection": "F",
"IsAlias": "N01",
"LACSAddress": "",
"LocationCode": "AS0",
"MatchCode": "S90",
"RecordType": "HighRise",
"GeoStanMatchScore": "0.0000000",
"CountryLevel": "A",
"StreetDataType": "TOMTOM",
"StreetDataCode": "2",
"DatabaseVersion": "July 2015",
"ExpirationDate": "11/27/2015",
"BlockLeft": "090010213001010",
"BlockRight": "090010212002010",
"BlockSuffixLeft": "",
"BlockSuffixRight": "",
"RoadClass": "00",
"SegmentDirection": "F",
"SegmentHouseNumberHigh": "3001",
"SegmentHouseNumberLow": "2988",
"SegmentCode": "72822",
"SegmentLength": "",
"SegmentParity": "R",
"PointCode": "",
"Confidence": "89",
"ProcessedBy": "KGL",
"Geocoder.MatchCode": "S5HPNTSCZA",
"IsCloseMatch": "Y",
"GeoConfidenceCode": "ADDRESS",
"GeoConfidenceCentroidLatitude": "41.071067",
"GeoConfidenceCentroidLongitude": "-73.549161",
"PBKey": "",
"Status": "",
"Status.Code": "",
"Status.Description": "",
"StreetSegmentPoints": [{"SegmentPoints": [
{
"Latitude": "41.071051",
"Longitude": "-73.549348"
},
{
"Latitude": "41.071117",
"Longitude": "-73.549338"
}
]}],
"user_fields": []
}]}
Example with XML Response
The following example requests an XML response:
http://myserver:8080/rest/GeocodeUSAddress/results.xml?Data.AddressLine1=3001+Summer+St&Data.City=Stamford&Data.StateProvince=CT
https://spectrum.precisely.com/rest/GeocodeUSAddress/results.xml?Data.AddressLine1=3001+Summer+St&Data.City=Stamford&Data.StateProvince=CT
The XML returned by this request would be:
<xml.GeocodeUSAddressResponse xmlns="http://www.pb.com/spectrum/services/GeocodeUSAddress">
<output_port>
<Address>
<BlockSuffix/>
<CBSADivisionCode/>
<CBSAMetro>Y</CBSAMetro>
<CBSACode>14860</CBSACode>
<CensusBlockID>090010212002010</CensusBlockID>
<USFIPSCountyNumber>001</USFIPSCountyNumber>
<CSACode>408</CSACode>
<CensusTract>021200</CensusTract>
<USFIPSStateCode>09</USFIPSStateCode>
<USFIPSStateCountyCode>09001</USFIPSStateCountyCode>
<Latitude>41.071067</Latitude>
<Longitude>-73.549161</Longitude>
<StreetSide>R</StreetSide>
<BlockLine1/>
<BlockLine2/>
<BlockLine3/>
<BlockLine4/>
<BlockLine5/>
<BlockLine6/>
<FirmName>Stamford Square</FirmName>
<AddressLine1>3001 Summer St</AddressLine1>
<AddressLine2/>
<LastLine>Stamford, CT 06905-4317</LastLine>
<StreetName>Summer</StreetName>
<CrossStreetName/>
<LeadingDirectional/>
<CrossStreetLeadingDirectional/>
<HouseNumber>3001</HouseNumber>
<HouseNumber2/>
<TrailingDirectional/>
<CrossStreetTrailingDirectional/>
<StreetSuffix>St</StreetSuffix>
<CrossStreetSuffix/>
<ApartmentLabel/>
<ApartmentLabel2/>
<ApartmentNumber/>
<ApartmentNumber2/>
<AdditionalInputData/>
<City>Stamford</City>
<StateProvince>CT</StateProvince>
<PostalCode.Base>06905</PostalCode.Base>
<PostalCode.AddOn>4317</PostalCode.AddOn>
<PostalCode>06905-4317</PostalCode>
<PrivateMailbox.Designator/>
<PrivateMailbox/>
<USUrbanName/>
<Country>United States of America</Country>
<RRHC/>
<USCarrierRouteCode>C006</USCarrierRouteCode>
<USBCCheckDigit>7</USBCCheckDigit>
<PostalBarCode>431799</PostalBarCode>
<DeliveryPointCode>99</DeliveryPointCode>
<GovernmentBuilding/>
<USLOTCode>0012A</USLOTCode>
<USCarrierRouteSort>B</USCarrierRouteSort>
<USCityDelivery>Y</USCityDelivery>
<PostalCodeClass/>
<PostalFacility>P</PostalFacility>
<PostalCodeUnique/>
<CityStateRecordName>Stamford</CityStateRecordName>
<CityPreferredName>Stamford</CityPreferredName>
<CityShortName>Stamford</CityShortName>
<DPV>D</DPV>
<DPVFootnote>AAN1</DPVFootnote>
<CMRA>N</CMRA>
<Alternate>B</Alternate>
<HouseNumberHigh>3001</HouseNumberHigh>
<HouseNumberLow>3001</HouseNumberLow>
<HouseNumberParity>O</HouseNumberParity>
<UnitNumberHigh/>
<UnitNumberLow/>
<UnitNumberParity/>
<PostalCodeExtensionHigh>4317</PostalCodeExtensionHigh>
<PostalCodeExtensionLow>4317</PostalCodeExtensionLow>
<AddressLineResolved/>
<EWSMatch/>
<RecordType.Default>Y</RecordType.Default>
<Intersection>F</Intersection>
<IsAlias>N01</IsAlias>
<LACSAddress/>
<LocationCode>AS0</LocationCode>
<MatchCode>S90</MatchCode>
<RecordType>HighRise</RecordType>
<GeoStanMatchScore>0.0000000</GeoStanMatchScore>
<CountryLevel>A</CountryLevel>
<StreetDataType>TOMTOM</StreetDataType>
<StreetDataCode>2</StreetDataCode>
<DatabaseVersion>July 2015</DatabaseVersion>
<ExpirationDate>11/27/2015</ExpirationDate>
<BlockLeft>090010213001010</BlockLeft>
<BlockRight>090010212002010</BlockRight>
<BlockSuffixLeft/>
<BlockSuffixRight/>
<RoadClass>00</RoadClass>
<SegmentDirection>F</SegmentDirection>
<SegmentHouseNumberHigh>3001</SegmentHouseNumberHigh>
<SegmentHouseNumberLow>2988</SegmentHouseNumberLow>
<SegmentCode>72822</SegmentCode>
<SegmentLength/>
<SegmentParity>R</SegmentParity>
<PointCode/>
<Confidence>89</Confidence>
<ProcessedBy>KGL</ProcessedBy>
<Geocoder.MatchCode>S5HPNTSCZA</Geocoder.MatchCode>
<IsCloseMatch>Y</IsCloseMatch>
<GeoConfidenceCode>ADDRESS</GeoConfidenceCode>
<GeoConfidenceCentroidLatitude>41.071067</GeoConfidenceCentroidLatitude>
<GeoConfidenceCentroidLongitude>-73.549161</GeoConfidenceCentroidLongitude>
<StreetSegmentPoints>
<StreetSegments>
<SegmentPoints>
<SegmentPoint>
<Latitude>41.071051</Latitude>
<Longitude>-73.549348</Longitude>
</SegmentPoint>
<SegmentPoint>
<Latitude>41.071117</Latitude>
<Longitude>-73.549338</Longitude>
</SegmentPoint>
</SegmentPoints>
</StreetSegments>
</StreetSegmentPoints>
<PBKey/>
<Status/>
<Status.Code/>
<Status.Description/>
<user_fields/>
</Address>
</output_port>
</xml.GeocodeUSAddressResponse>