Service Returns SE01
- Why Is the service returning SE01?
As with most most web services, a request can fail for any number of reasons internal to the service and not due to user configuration. For reverse Geo, this may simply be that the service could not perform all the searches and computations necessary to determine the nearest location to the input before the service timed out. Depending on the use case, decreasing the
max distance search radius may actually be the best workaround.
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.
- 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.
- 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.
- What is the expected throughput?
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