Reverse GeoCoder:Request

← Reverse GeoCoder

A request consists of a protocol to make a call to the service, detailing desired elements. The minimum required elements in a request are your License Key and at least one set of geo-coordinates.

Reverse GeoCoder supports multiple protocols to access the service, including JSON, REST, and XML.

URL

REST, XML, JSON, etc.

Use	URL
Standard	http://reversegeo.melissadata.net/v3/WEB/ReverseGeoCode/DoLookup
Secure	https://reversegeo.melissadata.net/v3/WEB/ReverseGeoCode/DoLookup

JSONP

Use	URL
Standard	http://reversegeo.melissadata.net/v3/jsonp/ReverseGeoCode/DoLookup
Secure	https://reversegeo.melissadata.net/v3/jsonp/ReverseGeoCode/DoLookup

Field Names

This is a list of the request field names and their protocol naming conventions.

Field Name	Level	REST	JSON
Transmission Reference	Request	t	TransmissionReference
License Key		id	CustomerID
Latitude		lat	Latitude
Longitude		long	Longitude
MaxDistance		dist	MaxDistance
MaxRecords		recs	MaxRecords
Format		format

Request Elements

The following elements set the basic options for each request. These apply to the entire request, not the individual records.

Transmission Reference

Optional.

This is a string value that serves as a unique identifier for this set of records. It is returned as sent.

Protocol	Syntax
JSON	"TransmissionReference":"string"
REST	?t = string
XML	<TransmissionReference>string</TransmissionReference>

License Key

Required.

This is a string value containing the License Key issued to you for this product.

If this element is absent, the Web Service will return an error. To receive a License Key, please contact your Melissa sales representative at 1-800-MELISSA.

Protocol	Syntax
JSON	"CustomerID":"string"
REST	&id = string
XML	<CustomerID>string</CustomerID>

Latitude

Required.

The latitude geographic coordinate in decimal format.

Protocol	Syntax
JSON	"Latitude":"string"
REST	&lat = string
XML	<Latitude>string</Latitude>

Longitude

Required.

The longitude geographic coordinate in decimal format.

Protocol	Syntax
JSON	"Longitude":"string"
REST	&long = string
XML	<Longitude>string</Longitude>

MaxDistance

Optional.

The requested maximum distance (in miles). The maximum possible distance is 10 miles. If no MaxDistance is specified, the default is 10 miles.

Protocol	Syntax
JSON	"MaxDistance":"string"
REST	&dist = string
XML	<MaxDistance>string</MaxDistance>

MaxRecords

Optional.

The requested number of records. The Maximum number of records the user can get is 100 records. This is also the default if no MaxRecords is specified.

Protocol	Syntax
JSON	"MaxRecords":"string"
REST	&recs = string
XML	<MaxRecords>string</MaxRecords>

Format

Optional.

The desired format of the response. Possible values for this option are "json" or "xml".

Protocol	Syntax
REST	&format = string