Quickstart#
Introduction#
Welcome to the Melissa Data Reverse GeoCoder Service.
Reverse GeoCoder from Melissa Data is a Web Service that provides the nearest valid U.S addresses to a latitude and longitude coordinate. Reverse GeoCoder converts a geographic coordinate to a valid street address that can be used, for example, in mobile apps to locate a person in case of an emergency or to provide roadside help. It also can be used by mailers to create a targeted mailing list assembled from addresses grouped around a specific geographic location. Reverse GeoCoder is ideal for vehicle tracking, for location-based services, and other applications where you have a GPS signal with latitude and longitude and want information about the address or place this location represents.
Reverse GeoCoder can be used to:
Create a mailing list within a specific radius for targeted marketing.
Use in mobile apps for emergency location purposes & provide roadside help.
Identify the closest valid address(es) based on an input latitude and longitude
Provide the closest Postal Code(s), Carrier Route(s) or Plus4(s) based on an input latitude and longitude.
Create a dealer locator: Provide the closest valid address, Melissa Address Key (MAK) and distance from a provided list of MAKs based on an input latitude and longitude or MAK.
Reverse GeoCoder has the ability to:
Return suite name & number of suites in each address.
Return up to 100 addresses for each Lat/Long coordinate.
Support multiple protocols including JSON, XML, and REST.
System Requirements#
SSL/TLS 1.2+
Getting Started - What Can I Do?#
Lookup Addresses#
Reverse GeoCoder can identify the closest valid address(es) based on an input latitude and longitude.
Endpoint#
/V3/WEB/ReverseGeoCode/doLookup
Click here to go to the full endpoint documentation.
Try it Now#
curl -X GET "http://ReverseGeo.melissadata.net/V3/WEB/ReverseGeoCode/doLookup
?id={CustomerId}\
&lat={Latitude}\
&long={Longitude}\
&dist={MaxDistance}\
&recs={MaxRecords}\
&t={TransmissionReference}\
&opt={Options}\
&format=json" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
Lookup Postal Codes#
Reverse GeoCoder can identify the nearest Postal Codes centroids within a specified radius.
Endpoint#
/V3/WEB/ReverseGeoCode/doLookupPostalCodes
Click here to go to the full endpoint documentation.
Try it Now#
curl -X GET "https://reversegeo.melissadata.net/V3/WEB/ReverseGeoCode/doLookupPostalCodes
?id={{customerId}}\
&lat="33.63756710910554"\
&long="-117.60695049134513"\
&dist="100"\
&recs=\
&t=\
&opt=\
&format=json" \
-H "Content-Type: application/json" \
-H "Accept: application/json"
curl -X POST "https://reversegeo.melissadata.net/V3/WEB/ReverseGeoCode/doLookupPostalCodes" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"CustomerId":{{customerId}},
"Latitude":"33.63756710910554",
"Longitude":"-117.60695049134513",
"MaxDistance":"100",
"MaxRecords":"",
"Options":"",
"TransmissionReference":"ReverseGeo DoLookup Test"
}'
curl -X GET "https://reversegeo.melissadata.net/V3/WEB/ReverseGeoCode/doLookupPostalCodes\
?id={{customerId}}\
&lat="33.63756710910554"\
&long="-117.60695049134513"\
&dist=\
&recs=\
&t=\
&opt=\
&format=xml" \
-H "Content-Type: application/xml" \
-H "Accept: application/xml"
curl -X POST "https://reversegeo.melissadata.net/V3/WEB/ReverseGeoCode/doLookupPostalCodes" \
-H "Content-Type: application/xml" \
-H "Accept: application/xml" \
-d '<RequestArray>
<CustomerId>{{customerId}}</CustomerId>
<Latitude>33.63756710910554</Latitude>
<Longitude>-117.60695049134513</Longitude>
<MaxDistance>100</MaxDistance>
<MaxRecords></MaxRecords>
<Options></Options>
<TransmissionReference>ReverseGeo DoLookup Test</TransmissionReference>
</RequestArray>'
Sample Code#
Language |
Repository |
|---|---|
C# .NET |
|
Python3 |
|
Postman Collection |
