Reverse GeoCoder:FAQ

From Melissa Data Wiki
Revision as of 00:21, 30 March 2022 by Admin (talk | contribs)
Jump to navigation Jump to search

← Reverse GeoCoder


Maximum Records Per Request

What's the maximum number of records that the user can get per request?

The Maximum number of records returned by the service is 100. Setting a higher number (Or no number at all) in the request MaxRecords field will not change this limit.


Maximum Distance

What's the maximum distance allowed?

The Maximum is 10 miles regardless whether the user specifies a higher number in the MaxDistance field, or doesn't specify anything at all.


Mandatory Fields

What fields are mandatory in the request?

The mandatory fields are CustomerID, Latitude and Longitude. MaxRecords and MaxDistance are optional. If They are not specified, the default value for MaxRecords is 100 records, and for MaxDistance it's 10 miles.


Supported Lat/Long Formats

What Lat/Long formats does the service accept?

The service accepts only the decimal representation of the Lat and Long. Formats such as:
116°14'28.86"W or -116 14 28.86 will not be accepted. East/West, Minutes/Seconds formats will have to be converted by the user prior calling the service.


Percentage of Accuracy

Is there a percentage to the accuracy of the results returned?

The Distance returned (in miles) between the input and the output point will serve as an indicator of accuracy. A distance of zero means an exact match was returned.


Service Update Frequency

How often is the service updated?

Reverse Geo is updated on a scheduled quarterly basis. Additionally, the service may also be updated as needed.


Service Throughput

What is the expected throughput?

The expected throughput is approximately 1,500,000 records per hour.

Service Endpoint Throughput (records / hour)
doLookUp 70,000
doLookUpPostalCode 92,000
doLookUpFromList 85,000


Service factors affecting throughput
  • Distribution of the data
    If inputs are randomly distributed over a wide range of areas, the searching algorithm for a particular input will require more of the underlying geo data to be accessed.
  • Input data
    Input data representing rural areas, a large search radius, and or large number of response addresses will all result in more searches and algorithms performed to return the de3sired number of locations
  • Number of threads
    The above benchmark is for a single thread of 1 record batches. Because each service call may request up to 100 response records, the service was developed as a single input request with request size, response computation time, and response time taken to consideration. Increasing the number of threads can greatly increase throughput. Users should thoroughly test the effects of the number of threads against network configuration to determine the most optimal usage.
Average Response Time Average (ms / record)
Single request 28ms
P95 Latency 64ms