Returns the latitude and longitude for a given US address. This operation will use cascading logic when an exact address match is not found and it will return the next closest level match available. The operation output is designed to allow the service to return new pieces of data as they become available without having to re-integrate.
HTTP POST Request Help Page
GetBestMatch_V4 tries to find a match at the most granular level that it can:
- Property Match on the street level
- Zip + 4 Match
- Zip + 3 Match
- Zip + 2 Match
- Zip + 1 Match
- Zip Match
- City/State Match (least accurate)
This operation will also return a code indicating the level at which it matched. The codes are:
S – Street Level Property Match
P – Zip plus four match
R – Zip plus three match
T – Zip plus two match
N – Zip plus one match
Z – Zip level match (zip plus zero)
C – City/state match
Address line of the address to geocode. For example, "123 Main Street".
The city of the address to geocode. For example, "New York". The city isn't required, but if one is not provided, the Zip code is required.
The state of the address to geocode. For example, "NY". This does not need to be contracted, full state names will work as well.The state isn't required, but if one is not provided, the Zip code is required.
The zip code of the address to geocode. A zip code isn't required, but if one is not provided, the City and State are required.
Your license key to use the service.
The level code at which the
|LevelDescription||String||Varies||An explicit description of the level code, described above.|
The latitude of the given address.
The longitude of the given address.
The corrected zip plus four of the given address.
|InformationComponents||InformationComponent array or NULL||Varies||A name-value pair collection containing additional information about the location. See the InformationComponent table and the list of Components for more details.|
Error object indicating why the service could not return a result. See “Errors” below for more information.
|Name||String||Varies||The component name of the Name-Value pair. Possible examples are "CountyFIPS", "CensusTract" "CensusGeoID"|
|Value||String||Varies||The component value of the Name-Value pair.|
Current List of Components
|StateFIPS||String||2 Digit Number||State FIPS(Federal Information Processing Standard) code; used to |
uniquely identity states.
|CountyFIPS||String||3 Digit Number||County FIPS(Federal Information Processing Standard) code; used to|
uniquely identify counties across the US.
|The census tract of the given address. |
A census tract is a statistical subdivision of a county.
|CensusBlock||String||4 Digit Number||The census block of the given address. |
A block is the smallest geographic unit used by the US Census.
|CensusGeoID||String||15 Digit Number||A Census based geographic identification code that uniquely identifies a geographic statistical area.|
|ClassFP||String||Alpha-Numeric||A code that defines the current class of the geographic location.|
|CongressCode||String||Varies||The congressional district number.|
|SLDUST||String||Varies||Current state legislative district upper (senate) chamber code.|
|SLDLST||String||Varies||Current state legislative district lower (house) chamber code|
The name of the place that the coordinates are associated with. Most commonly the name of a municipality, city, town, village or community.
NOTICE: For street level property matches the place name will reflect the name of the area where the exact coordinates reside. Coordinates for some unincorporated areas lie outside of known city/community boundaries. In this case the place name will reflect the name of the place that the address is associated with, which is most commonly derived from USPS postal data.
Indicates 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.
|TimeZone_UTC||String||Varies||The time zone in UTC offset format.|
|GoogleMapsURL||String||Varies||Google Maps URL with the coordinates to the location.|
|BingMapsURL||String||Varies||Bing Maps URL with the coordinates to the location.|
|MapQuestURL||String||Varies||Map Quest URL with the coordinates to the location.|