Reverse GeoCoder:Response: Difference between revisions

From Melissa Data Wiki
Jump to navigation Jump to search
← Older editNewer edit →
No edit summary
Line 6: Line 6:
{{CustomTOC}}
{{CustomTOC}}


==Response==
A response is the result of a request. This consists of returned results codes and returned addresses, depending on the input provided.
A response is the result of a request. This consists of returned results codes and returned addresses, depending on the input provided.


Depending on the protocol used to make the request, the response will be in a certain protocol. Reverse GeoCoder supports three possible response protocols: SOAP, XML, and JSON.
Depending on the protocol used to make the request, the response will be in a certain protocol. Reverse GeoCoder supports these response protocols: XML, and JSON.
 
 
==Field Names==
This is a list of the response field names and their protocol naming conventions.
 
{| class="alternate01 sortable"
!Field Name !! Level !! JSON/XML
|-
|Version||rowspan="4" valign="center"|Response (Base)||Version
|-
|Transmission Reference||TransmissionReference
|-
|Transmission Results||TransmissionResults
|-
|Results||Results
|-
|Total Records||TotalRecords
|-
|Records||rowspan="11" valign="center"|Record||Records
|-
|Address Line 1||AddressLine1
|-
|Suite Name||SuiteName
|-
|Suite Count||SuiteCount
|-
|City||City
|-
|State||State
|-
|Postal Code||PostalCode
|-
|AddressKey||AddressKey
|-
|Latitude||Latitude
|-
|Longitude||Longitude
|-
|Distance||Distance
|}
 
 
==Response Elements==
The following elements are the basic options for each request. These apply to the entire response, not the individual records.
 
<h3 style="background-color:rgb(240,240,240);">Version</h3>
:This is a string value that is the current revision number of Reverse GeoCoder.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"Version":"'''''string'''''"</code>
|-
|XML||<code><Version>'''''string'''''</Version></code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">Transmission Reference</h3>
:This is a string value that serves as a unique identifier for this set of records. It is returned as sent by the Request Array, allowing you to match the Response to the Request.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"TransmissionReference":"'''''string'''''"</code>
|-
|XML||<code><TransmissionReference>'''''string'''''</TransmissionReference></code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">Transmission Results</h3>
:This is a string value that lists error codes from any errors caused by the most recent request as a whole.
 
:For a complete list of error codes, see [[Result Code Details#Reverse GeoCoder|Reverse GeoCoder Result Codes]].
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"TransmissionResults":"'''''string'''''"</code>
|-
|XML||<code><TransmissionResults>'''''string'''''</TransmissionResults></code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">Results</h3>
:This is a string value with comma delimited status, error codes, and change codes for the record.
 
:For a complete list of error codes, see [[Result Code Details#Reverse GeoCoder|Reverse GeoCoder Result Codes]].
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"Results":"'''''string'''''"</code>
|-
|XML||<code><Results>'''''string'''''</Results></code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">Total Records</h3>
:Displays the total number of records returned.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"TotalRecords":"'''''string'''''"</code>
|-
|XML||<code><TotalRecords>'''''string'''''</TotalRecords></code>
|}
 
 
==Response Record Elements==
JSON will only contain the Records element.
 
:{| class="alternate01"
!Protocol !! Definition
|-
|JSON||Each record will be contained within [{}] under the Records element.
|-
|XML||
|}
 
Each of the following elements are returned for each record in the Response Array.
 
 
<h3 style="background-color:rgb(240,240,240);">AddressLine1</h3>
:Returns the street address (street number and street name) that corresponds to the input geo coordinates.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"AddressLine1":"'''''string'''''"</code>
|-
|XML||<code><AddressLine1>'''''string'''''</AddressLine1></code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">SuiteName</h3>
:Returns the suite name of the address returned. Values that could be returned are: Ste, Apt., etc.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"SuiteName":"'''''string'''''"</code>
|-
|XML||<code><SuiteName>'''''string'''''</SuiteName></code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">SuiteCount</h3>
:Returns the number of suites in a particular building. Zero will be returned if the address has a no suites (a single delivery point).
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"SuiteCount":"'''''string'''''"</code>
|-
|XML||<code><SuiteCount>'''''string'''''</SuiteCount></code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">City</h3>
:Returns the city of the output address.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"City":"'''''string'''''"</code>
|-
|XML||<code><City>'''''string'''''</City></code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">State</h3>
:Returns the State of the output address.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"State":"'''''string'''''"</code>
|-
|XML||<code><State>'''''string'''''</State></code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">PostalCode</h3>
:Returns the Postal Code of the output address.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"PostalCode":"'''''string'''''"</code>
|-
|XML||<code><PostalCode>'''''string'''''</PostalCode></code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">AddressKey</h3>
:Returns a unique identifier for an address. This key can be used with other current and future Melissa Data services.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"AddressKey":"'''''string'''''"</code>
|-
|XML||<code><AddressKey>'''''string'''''</AddressKey></code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">Latitude</h3>
:Returns the latitude geographic coordinate of the output address.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"Latitude":"'''''string'''''"</code>
|-
|XML||<code><Latitude>'''''string'''''</Latitude></code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">Longitude</h3>
:Returns the longitude geographic coordinate of the output address.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"Longitude":"'''''string'''''"</code>
|-
|XML||<code><Longitude>'''''string'''''</Longitude></code>
|}
 
 
<h3 style="background-color:rgb(240,240,240);">Distance</h3>
:Returns the distance between the input coordinates and the output coordinates. A distance of zero indicates that an exact address match was returned for the input geographic coordinates.
 
:{| class="alternate01"
!Protocol !! Syntax
|-
|JSON||<code>"Distance":"'''''string'''''"</code>
|-
|XML||<code><Distance>'''''string'''''</Distance></code>
|}




[[Category:Reverse GeoCoder]]
[[Category:Reverse GeoCoder]]
[[Category:Reference]]
[[Category:Reference]]

Revision as of 19:10, 8 March 2019

← 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



A response is the result of a request. This consists of returned results codes and returned addresses, depending on the input provided.

Depending on the protocol used to make the request, the response will be in a certain protocol. Reverse GeoCoder supports these response protocols: XML, and JSON.


Field Names

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

Field Name Level JSON/XML
Version Response (Base) Version
Transmission Reference TransmissionReference
Transmission Results TransmissionResults
Results Results
Total Records TotalRecords
Records Record Records
Address Line 1 AddressLine1
Suite Name SuiteName
Suite Count SuiteCount
City City
State State
Postal Code PostalCode
AddressKey AddressKey
Latitude Latitude
Longitude Longitude
Distance Distance


Response Elements

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

Version

This is a string value that is the current revision number of Reverse GeoCoder.
Protocol Syntax
JSON "Version":"string"
XML <Version>string</Version>


Transmission Reference

This is a string value that serves as a unique identifier for this set of records. It is returned as sent by the Request Array, allowing you to match the Response to the Request.
Protocol Syntax
JSON "TransmissionReference":"string"
XML <TransmissionReference>string</TransmissionReference>


Transmission Results

This is a string value that lists error codes from any errors caused by the most recent request as a whole.
For a complete list of error codes, see Reverse GeoCoder Result Codes.
Protocol Syntax
JSON "TransmissionResults":"string"
XML <TransmissionResults>string</TransmissionResults>


Results

This is a string value with comma delimited status, error codes, and change codes for the record.
For a complete list of error codes, see Reverse GeoCoder Result Codes.
Protocol Syntax
JSON "Results":"string"
XML <Results>string</Results>


Total Records

Displays the total number of records returned.
Protocol Syntax
JSON "TotalRecords":"string"
XML <TotalRecords>string</TotalRecords>


Response Record Elements

JSON will only contain the Records element.

Protocol Definition
JSON Each record will be contained within [{}] under the Records element.
XML

Each of the following elements are returned for each record in the Response Array.


AddressLine1

Returns the street address (street number and street name) that corresponds to the input geo coordinates.
Protocol Syntax
JSON "AddressLine1":"string"
XML <AddressLine1>string</AddressLine1>


SuiteName

Returns the suite name of the address returned. Values that could be returned are: Ste, Apt., etc.
Protocol Syntax
JSON "SuiteName":"string"
XML <SuiteName>string</SuiteName>


SuiteCount

Returns the number of suites in a particular building. Zero will be returned if the address has a no suites (a single delivery point).
Protocol Syntax
JSON "SuiteCount":"string"
XML <SuiteCount>string</SuiteCount>


City

Returns the city of the output address.
Protocol Syntax
JSON "City":"string"
XML <City>string</City>


State

Returns the State of the output address.
Protocol Syntax
JSON "State":"string"
XML <State>string</State>


PostalCode

Returns the Postal Code of the output address.
Protocol Syntax
JSON "PostalCode":"string"
XML <PostalCode>string</PostalCode>


AddressKey

Returns a unique identifier for an address. This key can be used with other current and future Melissa Data services.
Protocol Syntax
JSON "AddressKey":"string"
XML <AddressKey>string</AddressKey>


Latitude

Returns the latitude geographic coordinate of the output address.
Protocol Syntax
JSON "Latitude":"string"
XML <Latitude>string</Latitude>


Longitude

Returns the longitude geographic coordinate of the output address.
Protocol Syntax
JSON "Longitude":"string"
XML <Longitude>string</Longitude>


Distance

Returns the distance between the input coordinates and the output coordinates. A distance of zero indicates that an exact address match was returned for the input geographic coordinates.
Protocol Syntax
JSON "Distance":"string"
XML <Distance>string</Distance>
Retrieved from "http://wiki.melissadata.com/index.php?title=Reverse_GeoCoder:Response&oldid=16105"