Difference between revisions of "Reverse GeoCoder:Introduction"

From Melissa Data Wiki
Jump to navigation Jump to search
Line 1: Line 1:
[[Reverse GeoCoder Web Service:Reference|← Reverse GeoCoder Web Service Reference]]
{{ ReverseGeoCoderNav
 
|IntroductionCollapse=
{| class="mw-collapsible" cellspacing="2" style="background-color:#f9f9f9; border:1px solid #aaaaaa; font-size:9pt; color:#0645ad; padding:8px 8px;"
}}
! style="text-align:left; color:black; border-bottom:1px solid #aaaaaa;"|'''Reverse GeoCoder Web Service Navigation'''
|-
| style="padding-right:220px;"|
|-
|
{| class="mw-collapsible" style="width:100%;"
|- align="left"
! style="color:black;"|[[Reverse GeoCoder Web Service:Introduction|Introduction]]
|-
|[[Reverse GeoCoder Web Service:Licensing|Licensing]]
|}
|-
|
{| class="mw-collapsible mw-collapsed" style="width:100%;"
|- align="left"
! style="color:black;"|[[Reverse GeoCoder Web Service:Request|Request]]
|-
|[[Reverse GeoCoder Web Service:Request Elements|Request Elements]]
|-
|[[Reverse GeoCoder Web Service:Example Request|Example Request]]
|}
|-
|
{| class="mw-collapsible mw-collapsed" style="width:100%;"
|- align="left"
! style="color:black;"|[[Reverse GeoCoder Web Service:Response|Response]]
|-
|[[Reverse GeoCoder Web Service:Response Elements|Response Elements]]
|-
|[[Reverse GeoCoder Web Service:Response Record Elements|Response Record Elements]]
|-
|[[Reverse GeoCoder Web Service:Example Response|Example Response]]
|}
|-
|
{| class="mw-collapsible mw-collapsed" style="width:100%;"
|- align="left"
! style="color:black;"|[[Reverse GeoCoder Web Service:Result Codes|Result Codes]]
|-
|[[Reverse GeoCoder Web Service:Result Codes#Result Code Use|Result Code Use]]
|-
|[[Returned Result Codes:Web Services#Reverse GeoCoder Web Service|Returned Result Codes]]
|}
|-
|
{| <!--class="mw-collapsible mw-collapsed"--> style="width:100%;"
|- align="left"
! style="color:black;"|[[Reverse GeoCoder Web Service:Sample Code|Sample Code]]
|}
|}




{{CustomTOC}}
{{CustomTOC}}


Welcome to the Melissa Data Reverse GeoCoder Web Service. This web service provides the closest valid address(s), based on an input latitude and longitude. The user can optionally set the distance from the input coordinates – to reduce the number of returned output addresses, and a maximum number of records to be returned by the service.
Welcome to the Melissa Data Reverse GeoCoder Service. This service provides the closest valid address(s), based on an input latitude and longitude. The user can optionally set the distance from the input coordinates – to reduce the number of returned output addresses, and a maximum number of records to be returned by the service.


In addition to valid addresses, the service will also return location information and an AddressKey. AddressKey can be used by other Melissa Data services to obtain additional information, such as RBDI (Residential/Business Delivery Indicator) or Property information.
In addition to valid addresses, the service will also return location information and an AddressKey. AddressKey can be used by other Melissa Data services to obtain additional information, such as RBDI (Residential/Business Delivery Indicator) or Property information.
Line 83: Line 33:


==Single Record vs Batch==
==Single Record vs Batch==
ReverseGeo web service takes only one record at a time. In other words each request has only one set of geo coordinates (latitude and longitude), but it does return an array of responses if multiple valid addresses are at that particular location.
Reverse GeoCoder takes only one record at a time. In other words each request has only one set of geo coordinates (latitude and longitude), but it does return an array of responses if multiple valid addresses are at that particular location.




[[Category:Reverse GeoCoder Web Service]]
[[Category:Reverse GeoCoder]]
[[Category:Reference]]
[[Category:Reference]]

Revision as of 23:04, 10 March 2015

← Reverse GeoCoder

Reverse GeoCoder Navigation
Introduction
Licensing
Input/Output
doLookup
  ↳  Request
  ↳  Response
doLookupPostalCodes
  ↳  Request
  ↳  Response
doLookupFromList
  ↳  Request
  ↳  Response
Examples
REST XML
REST JSON
JSON
XML
Result Codes
Result Code Use
Reverse GeoCoder Result Codes
Sample Code



Welcome to the Melissa Data Reverse GeoCoder Service. This service provides the closest valid address(s), based on an input latitude and longitude. The user can optionally set the distance from the input coordinates – to reduce the number of returned output addresses, and a maximum number of records to be returned by the service.

In addition to valid addresses, the service will also return location information and an AddressKey. AddressKey can be used by other Melissa Data services to obtain additional information, such as RBDI (Residential/Business Delivery Indicator) or Property information.


Basic Procedures

Using ReverseGeo starts with creating a request. It must include your customer ID which serves as a key for accessing the service. You also need to select any options you want it to use, and how many records you want returned.

The main points in preparing a request for ReverseGeo are:

  • Customer ID
  • Input (Latitude, Longitude)
  • Options (MaxDistance, MaxRecords)

Once the request is finished, you send it to the service and get back the response. The response contains a list of records that are the closest to the coordinates specified in the request. Each record in the response contains a deliverable address.


Options

There are two optional properties that the user can specify in the request: MaxDistance, and MaxRecords. These optional fields allow users to configure how they want the service to behave.


Results

Every response has an output property called Results, which describes the response we sent back. Generally, the codes tell you whether we were able to find a deliverable address(s) at the specified location, the coordinates are out of region (no addresses to return), or a status of any issues with the coordinates/request.


Single Record vs Batch

Reverse GeoCoder takes only one record at a time. In other words each request has only one set of geo coordinates (latitude and longitude), but it does return an array of responses if multiple valid addresses are at that particular location.