Table of Contents
Get item info by coordinates
To get information about any item on a graphic layer by its coordinates, use the request:
http://{host}/avl_hittest?rname=<text>&lat=<double>&lon=<double>&scale=<uint>&
radius=<double>&sdk=<text>
Attention
Before executing that command please create appropriate layer using next commands: Create POI layer, Create geofence layer, Create track layer.
Parameters
| Name | Description |
|---|---|
| rname | renderer name (see Create image renderer) |
| lat | latitude |
| lon | longitude |
| scale | zoom: 0-17 |
| radius | search radius |
| sdk | request is sent through SDK: 0 - no, 1 - yes (for compatibility with old versions), common usage - 1. Use value of this parameter without quotes, otherwise you'll get ERROR in result. |
Response
For messages:
{ "type":2, /* result type (2 - message) */ "msg":{ /* current message */ ... }, "_msg":{ /* previous message */ ... }, "imsg":<uint>, /* index of current message */ "unit_id":<long> /* unit ID */ }
Formats of current and previous messages are described in the chapter Data format: Messages.
For markers:
{ "type":1, /* result type (1 - marker) */ "lat":<double>, /* latitude */ "lon":<double>, /* longitude */ "header":<text>, /* marker name */ "text":<text>, /* information about the marker: depends on marker type */ "marker":{} /* additional information about the marker if exists */ }
For geofences:
{ "type":3, /* result type (3 - geofence) */ "lat":<double>, /* latitude */ "lon":<double>, /* longitude */ "rname":<text>, /* renderer name */ "lname":<text>, /* layer name */ "shape":{} /* information about the geofence, for example name */ }
