1. Geo API usage statistics

Important
This API requires SESSION authentication via /login

Curl request

$ curl 'https://utils.limosys.net/geo/log?limit=20' -i -X GET \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'Accept: application/json'

HTTP request

GET /geo/log?limit=20 HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Host: utils.limosys.net

HTTP response

HTTP/1.1 200 OK
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: POST, GET, PUT, OPTIONS, DELETE
Access-Control-Max-Age: 3600
Access-Control-Allow-Headers: origin, content-type, accept, authorization
Access-Control-Allow-Credentials: true
Access-Control-Expose-Headers: Set-Cookie
Content-Type: application/json
Content-Length: 4852
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Strict-Transport-Security: max-age=31536000 ; includeSubDomains
X-Frame-Options: DENY

Geo API access in last 20 minutes:<br><br><b>GEOCODE_THIRDPARTY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_THIRDPARTY_MB</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_THIRDPARTY_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_LOCAL</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_REVERSE_LOCAL</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_REVERSE_THIRDPARTY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_REVERSE_MB</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_REVERSE_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_BAD_INPUT</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_BAD_RESULT</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_BAD_RESULT_CACHE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_THIRDPARTY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_THIRDPARTY_MB</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_THIRDPARTY_BING</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_LOCAL</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_LOCAL_TRAFFIC</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCACHE_MATRIX</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCACHE_MATRIX_TRAFFIC</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCACHE_GEOCODE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_AUTO_LOCAL</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_AUTO_THIRDPARTY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_AUTO_GOOGLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_AUTO_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_AUTO_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_DETAIL_LOCAL</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_DETAIL_GOOGLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_DETAIL_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_DETAIL_THIRDPARTY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_DETAIL_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_TRAFFIC</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_VERIFY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_TRAFFIC_VERIFY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_THIRDPARTY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_THIRDPARTY_GOOGLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_THIRDPARTY_MB</b>: 1234 (elements: 43210) avg time: 200ms<br><b>BAD_API_KEY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMANAGER</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_FETCH</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_FETCH_MOCK</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_FETCH_NOTRAFFIC</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_MISS_MINUTES</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_MISS_CELLS</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_NOCACHE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>LS_ESTIMATE_OVERRIDE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_REFRESH</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_BING</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_GOOGLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_LSAPI</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_MB</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_HEARTBEAT_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_HEARTBEAT_GOOGLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_HEARTBEAT_MAPBOX</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_HEARTBEAT_LSAPI</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_REFRESH</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_GEOCACHE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_GOOGLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_LSAPI</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_MB</b>: 1234 (elements: 43210) avg time: 200ms<br>

HTTPie request

$ http GET 'https://utils.limosys.net/geo/log?limit=20' \
    'Content-Type:application/json;charset=UTF-8' \
    'Accept:application/json'

Request body

Request parameters

Parameter Description

limit

How many minutes to show (Optional)

Response body

Geo API access in last 20 minutes:<br><br><b>GEOCODE_THIRDPARTY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_THIRDPARTY_MB</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_THIRDPARTY_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_LOCAL</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_REVERSE_LOCAL</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_REVERSE_THIRDPARTY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_REVERSE_MB</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_REVERSE_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_BAD_INPUT</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_BAD_RESULT</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_BAD_RESULT_CACHE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_THIRDPARTY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_THIRDPARTY_MB</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_THIRDPARTY_BING</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_LOCAL</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_LOCAL_TRAFFIC</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCACHE_MATRIX</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCACHE_MATRIX_TRAFFIC</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCACHE_GEOCODE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_AUTO_LOCAL</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_AUTO_THIRDPARTY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_AUTO_GOOGLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_AUTO_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_AUTO_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_DETAIL_LOCAL</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_DETAIL_GOOGLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_DETAIL_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_DETAIL_THIRDPARTY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>PLACES_DETAIL_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_TRAFFIC</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_VERIFY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_TRAFFIC_VERIFY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_THIRDPARTY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_THIRDPARTY_GOOGLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_THIRDPARTY_MB</b>: 1234 (elements: 43210) avg time: 200ms<br><b>BAD_API_KEY</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMANAGER</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_FETCH</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_FETCH_MOCK</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_FETCH_NOTRAFFIC</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_MISS_MINUTES</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_MISS_CELLS</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>HEATMAP_NOCACHE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>LS_ESTIMATE_OVERRIDE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_REFRESH</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_BING</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_GOOGLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_LSAPI</b>: 1234 (elements: 43210) avg time: 200ms<br><b>MATRIX_HEARTBEAT_MB</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_HEARTBEAT_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_HEARTBEAT_GOOGLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_HEARTBEAT_MAPBOX</b>: 1234 (elements: 43210) avg time: 200ms<br><b>DIRECTIONS_HEARTBEAT_LSAPI</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_CACHED</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_REFRESH</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_GEOCACHE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_APPLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_GOOGLE</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_LSAPI</b>: 1234 (elements: 43210) avg time: 200ms<br><b>GEOCODE_HEARTBEAT_MB</b>: 1234 (elements: 43210) avg time: 200ms<br>

2. Matrix ETA reporting

Curl request

$ curl 'https://utils.limosys.net/geo/log/matrixerror?key=YOUR_GEO_API_KEY&phoneNum=000.000.0000&jobId=1234567&answers=Too+Low%3BGoogle%3B' -i -X POST \
    -H 'Content-Type: application/json;charset=UTF-8' \
    -H 'Accept: application/json' \
    -d '{"results":[{"matrix":[{"dist_meters":5000,"dist":3.1068559611866697,"time":8,"timeSeconds":500,"lat1":1.0,"lon1":1.0,"lat2":2.0,"lon2":2.0,"location1":"","location2":""}],"traffic":false}],"detailedResult":{"matrix":[{"dist_meters":5000,"dist":3.1068559611866697,"time":8,"timeSeconds":500,"lat1":1.0,"lon1":1.0,"lat2":2.0,"lon2":2.0,"location1":"","location2":""}],"traffic":false}}'

HTTP request

POST /geo/log/matrixerror?key=YOUR_GEO_API_KEY&phoneNum=000.000.0000&jobId=1234567&answers=Too+Low%3BGoogle%3B HTTP/1.1
Content-Type: application/json;charset=UTF-8
Accept: application/json
Content-Length: 384
Host: utils.limosys.net

{"results":[{"matrix":[{"dist_meters":5000,"dist":3.1068559611866697,"time":8,"timeSeconds":500,"lat1":1.0,"lon1":1.0,"lat2":2.0,"lon2":2.0,"location1":"","location2":""}],"traffic":false}],"detailedResult":{"matrix":[{"dist_meters":5000,"dist":3.1068559611866697,"time":8,"timeSeconds":500,"lat1":1.0,"lon1":1.0,"lat2":2.0,"lon2":2.0,"location1":"","location2":""}],"traffic":false}}

HTTP response

HTTP/1.1 200 OK
Access-Control-Allow-Origin: *
Access-Control-Allow-Methods: POST, GET, PUT, OPTIONS, DELETE
Access-Control-Max-Age: 3600
Access-Control-Allow-Headers: origin, content-type, accept, authorization
Access-Control-Allow-Credentials: true
Access-Control-Expose-Headers: Set-Cookie
X-Content-Type-Options: nosniff
X-XSS-Protection: 1; mode=block
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
Strict-Transport-Security: max-age=31536000 ; includeSubDomains
X-Frame-Options: DENY

HTTPie request

$ echo '{"results":[{"matrix":[{"dist_meters":5000,"dist":3.1068559611866697,"time":8,"timeSeconds":500,"lat1":1.0,"lon1":1.0,"lat2":2.0,"lon2":2.0,"location1":"","location2":""}],"traffic":false}],"detailedResult":{"matrix":[{"dist_meters":5000,"dist":3.1068559611866697,"time":8,"timeSeconds":500,"lat1":1.0,"lon1":1.0,"lat2":2.0,"lon2":2.0,"location1":"","location2":""}],"traffic":false}}' | http POST 'https://utils.limosys.net/geo/log/matrixerror?key=YOUR_GEO_API_KEY&phoneNum=000.000.0000&jobId=1234567&answers=Too+Low%3BGoogle%3B' \
    'Content-Type:application/json;charset=UTF-8' \
    'Accept:application/json'

Request body

{"results":[{"matrix":[{"dist_meters":5000,"dist":3.1068559611866697,"time":8,"timeSeconds":500,"lat1":1.0,"lon1":1.0,"lat2":2.0,"lon2":2.0,"location1":"","location2":""}],"traffic":false}],"detailedResult":{"matrix":[{"dist_meters":5000,"dist":3.1068559611866697,"time":8,"timeSeconds":500,"lat1":1.0,"lon1":1.0,"lat2":2.0,"lon2":2.0,"location1":"","location2":""}],"traffic":false}}

Request fields

Path Type Description

results[]

MatrixRes[]

All results (for this Job) to report

detailedResult

MatrixRes

Additional result obtained with details=yes at the time of report (Optional)

Request parameters

Parameter Description

key

Limosys API Key

phoneNum

Phone number of the driver or Device ID

jobId

Job/Trip ID if available

answers

Answers to provided questions - e.g. Too low, Too high, what provider was used, semi-colon separated (Optional)

Response body