Quickstart#

Introduction#

Welcome to the Melissa Reverse GeoCoder Service.

Reverse GeoCoder from Melissa 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#

  • GET JSON
  • POST JSON
  • GET XML
  • POST XML
curl -X GET "https://ReverseGeo.melissadata.net/V3/WEB/ReverseGeoCode/doLookup?\
&dist="10"\
&format=JSON\
&id={{customerId}}\
&lat="33.63756710910554"\
&long="-117.60695049134513"\
&opt=\
&recs=\
&t=Test" \
-H "Content-Type: application/json" \
-H "Accept: application/json"

curl -X POST "https://reversegeo.melissadata.net/V3/WEB/ReverseGeoCode/doLookup" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
       "CustomerId": {{customerId}},
       "Latitude": "33.63756710910554",
       "Longitude": "-117.60695049134513",
       "MaxDistance": "10",
       "MaxRecords": "",
       "Options": "",
       "TransmissionReference": "Test"
    }'

curl -X GET "https://ReverseGeo.melissadata.net/V3/WEB/ReverseGeoCode/doLookup?\
&dist="10"\
&format=XML\
&id={{customerId}}\
&lat="33.63756710910554"\
&long="-117.60695049134513"\
&opt=\
&recs=\
&t=Test" \
-H "Content-Type: application/xml" \
-H "Accept: application/xml"

curl -X POST "https://reversegeo.melissadata.net/V3/WEB/ReverseGeoCode/doLookup" \
-H "Content-Type: application/xml" \
-H "Accept: application/xml" \
-d '<RequestArray>
       <CustomerId>{{customerId}}</CustomerId>
       <Latitude>33.63756710910554</Latitude>
       <Longitude>-117.60695049134513</Longitude>
       <MaxDistance>10</MaxDistance>
       <MaxRecords></MaxRecords>
       <Options></Options>
       <TransmissionReference>Test</TransmissionReference>
    </RequestArray>'

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#

  • GET JSON
  • POST JSON
  • GET XML
  • POST XML
curl -X GET "https://reversegeo.melissadata.net/V3/WEB/ReverseGeoCode/doLookupPostalCodes?\
&dist="10"\
&format=json\
&id={{customerId}}\
&lat="33.63756710910554"\
&long="-117.60695049134513"\
&opt=\
&recs=\
&t=Test" \
-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": "10",
       "MaxRecords": "",
       "Options": "",
       "TransmissionReference": "Test"
    }'

curl -X GET "https://reversegeo.melissadata.net/V3/WEB/ReverseGeoCode/doLookupPostalCodes?\
&dist="10"\
&format=xml\
&id={{customerId}}\
&lat="33.63756710910554"\
&long="-117.60695049134513"\
&opt=\
&recs=\
&t=Test" \
-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>10</MaxDistance>
       <MaxRecords></MaxRecords>
       <Options></Options>
       <TransmissionReference>Test</TransmissionReference>
    </RequestArray>'

Lookup from List#

Reverse GeoCoder can take in an origin address and one or more target addresse(s) to perform a distance comparison and return the closest target addresse(s) to the origin address.

Endpoint#

/V3/WEB/ReverseGeoCode/doLookupFromList

Click here to go to the full endpoint documentation.

Try it Now#

  • POST JSON
curl -X POST "https://ReverseGeo.melissadata.net/V3/WEB/ReverseGeoCode/doLookupFromList" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
       "CustomerId": {{customerId}},
       "Latitude": "33.63756710910554",
       "Longitude": "-117.60695049134513",
       "MaxDistance": "10",
       "MaxRecords": "",
       "Options": "",
       "Records":
       [{
          "MelissaAddressKey": "8008006245",
          "RecordID": "1"
       },{
          "MelissaAddressKey": "5328287925",
          "RecordID": "2"
       }],
       "TransmissionReference": "Reverse Geo LookupFromList Test"
    }'

Sample Code#

Language

Repository

C# .NET

melissa_favicon MelissaData/ReverseGeocoder-Dotnet

Python3

melissa_favicon MelissaData/ReverseGeocoder-Python3

Postman Collection

melissa_favicon MelissaData/ReverseGeocoder-Postman