The ReverseSearch operation returns the address or place information for a given set of coordinates, along with additional address and location information. It will attempt to reverse geocode coordinates and return international addresses at the property level, which is often at the premise level resolution for some properties and then cascade to the next best available resolution such as the street, neighborhood, postal code, locality and so on. For non-address places such as streets, cities and postal codes returned by the service, the coordinates output in the response body will represent a coordinate point that is commonly associated with the location or a centroid for the area.

URL Endpoints

HTTP GET Request Help Page

HTTP POST Request Help Page

ReverseSearch Inputs

NameTypeDescription
Latitude*StringThe latitude of the location.
A decimal number up to 10 digits with a max precision of up
to 7 places after the decimal point.
Longitude*StringThe longitude of the location.
A decimal number up to 10 digits with a max precision of up
to 7 places after the decimal point. 
SearchRadiusStringThe maximum search radius distance set in kilometers.
Defaults to 1. Maximum value of 50.
CountryStringThe preferred name of the country or the ISO 3166-1 Alpha-2
Country Code or the Alpha-3 Country Code. Some alternate
country names and spellings are supported, but the use of the
common English spelled name or ISO2 country code is
recommended for best results.
MaxResultsStringSets the maximum number of results the operation is allowed
to return. Acceptable values range from 1 to 10. 
SearchType*StringThe name of the type of search you want to perform for the
given address or place. See “Search Types” for more
information.
LicenseKey*StringYour license key to use the service.
Sign up for a free trial key at 
https://www.serviceobjects.com/address-geocode/

*   Required

ReverseSearch Outputs

NameTypeValuesDescription
SearchInfoSearchInfoVariesContains status, notes and warning information
about the query as well as the number of
locations returned. This object is always
returned.
LocationsLocationInfo[]VariesContains a list of LocationInfo objects. If a best
match is found then the service will contain a
single location. If a single best match cannot be
found or if the ‘SearchType’ input value is set to
‘All’ then the list will contain no more than the
maximum number of locations set by the
‘MaxResults’ input.
ErrorErrorVariesError object indicating why the service could
not return a result. See “Errors” page for more
information.
NameTypeValuesDescription
StatusStringSee “Status” for
descriptions and
possible values.		Indicates if the service found
one or more results or if it
encountered an error when
processing the query.
NumberOfLocationsStringNumber
Max Range of
0 – 10		Indicates the number of
locations found for the query
that will be listed in
LocationInfo array Locations.
The default maximum
number of location returned
by the service is 10; however,
a lower value can be set in
the ‘MaxResults’ input.
NotesString
or
NULL		See “Note Codes &
Descriptions” for
possible values and
details.		Comma-separated list of
descriptive note codes about
the query.
NotesDescString
or
NULL		See “Note Codes &
Descriptions” for
possible values and
details.		Comma-separated list of
descriptions that correspond
to the Notes output.
WarningsString
or
NULL		See “Warning Codes &
Descriptions” for
possible values and
details.		Comma-separated list of
warning codes about the
query.
WarningDescString
or
NULL		See “Warning Codes &
Descriptions” for
possible values and details.		Comma-separated list of
descriptions that correspond
to the Warnings output.
NameTypeValuesDescription
PrecisionLevelStringNumber
Ranges 1
– 16		Indicates how precise the
coordinates are. Levels range
from 1 – 16. The higher the
number the higher the
precision. See “Precision
Levels” for more details.
TypeStringSee
“Types“
for
possible
values
and
details.		Indicates what type of
location the coordinates are
for. For example, the location
may be for an address,
thoroughfare, locality or
postal code.
LatitudeStringVariesThe latitude of the location.
A decimal number up to 10
digits with a max precision of
up to 7 places after the
decimal point.
LongitudeStringVariesThe longitude of the location.
A decimal number up to 10
digits with a max precision of
up to 7 places after the
decimal point. 
AddressComponents
AddressComponents
VariesA name-value pair collection
containing additional
information about the
location. See the
“AddressComponents” table
and the list of Components
for more details.
NameTypeValuesDescription
PremiseNumberString
or NULL		VariesThe number associated with
the property. Also known as the
Address, Street or House
number.
ThoroughfareString
or NULL		VariesThe name of the thoroughfare.
Also known as a street, road,
highway, etc.
DoubleDependentLocalityString
or NULL		VariesThe name of the double
dependent locality.
DependentLocalityString
or NULL		VariesThe name of the dependent
locality.
LocalityString
or NULL		VariesThe preferred English name of
the locality, such as a City,
Town or other type of
Municipality.
AdministrativeArea1String
or NULL		VariesThe name of the primary
administrative division, such as
a State, Region, Province,
County, Territory or Prefecture.
AdministrativeArea1AbbreviationString
or NULL		VariesThe abbreviated name of the
primary administrative area.
AdministrativeArea2String
or NULL		VariesThe name of the secondary
administrative division, such as
a County or Region.
AdministrativeArea2AbbreviationString
or NULL		VariesThe abbreviated name of the
secondary administrative area.
AdministrativeArea3String
or NULL		VariesThe name of the third level
administrative division, such as
a Borough or District.
AdministrativeArea3AbbreviationString
or NULL		VariesThe abbreviated name of the
tertiary administrative area.
AdministrativeArea4String
or NULL		VariesThe name of the fourth level
administrative division, such as
a Ward or Quarter.
AdministrativeArea4Abbreviation
String
or NULL		Varies
The abbreviated name of the
quaternary administrative area.
PostalCodeString
or NULL		VariesThe postal code of the
international address.
CountryString
or NULL		VariesThe country
CountryISO2String
or NULL		VariesThe 2-letter country
abbreviation.
CountryISO3String
or NULL		Varies
The 3-letter country
abbreviation.
GoogleMapsURL **String
or NULL		VariesGoogle Maps URL with the
coordinates to the location.
PlaceName *String
or NULL		VariesThe name of the place that the
coordinates are associated
with. Most commonly the name
of a municipality, city, town,
village or community.
IsUnincorporated *String
or NULL		VariesIndicates if the coordinates are
for an unincorporated area.
Only appears for street level
property matches (S).
1 – Indicates that the
coordinates fall within the
boundaries of a known
unincorporated area.
2 – Indicates that the
coordinates fall outside of the
boundaries of a known area.
StateFIPS *String
or NULL		2 Digit NumberState FIPS (Federal Information
Processing Standard) code;
used to
uniquely identity states.
CountyFIPS *String
or NULL		3 Digit NumberCounty FIPS (Federal
Information Processing
Standard) code; used to
uniquely identify counties
across the US.
CensusTract *String
or NULL		6 Digit
Decimal Number		The census tract of the given
address.
A census tract is a statistical
subdivision of a county.
CensusBlock *String
or NULL		4 Digit NumberThe census block of the given
address.
A block is the smallest
geographic unit used by the US
Census.
CensusGeoID *String
or NULL		15 Digit NumberA Census based geographic
identification code that
uniquely identifies a
geographic statistical area.
ClassFP *String
or NULL		Alpha-NumericA code that defines the current
class of the geographic US
location.
CongressCode *String
or NULL		VariesThe congressional district
number.
SLDUST *String
or NULL		Varies
Current state legislative district
upper (senate) chamber code.
SLDLST *String
or NULL		VariesCurrent state legislative district
lower (house) chamber code
Timezone_UTC ***String
or NULL		NumberThe time zone in UTC offset
format.

* Only available when ‘Census’ is included in the input value for Extras.

** Only available when ‘URLs’ is included in the input value for Extras. 

References