Localization

How to send localization data to twinzo REST API

Configuration
Please see the sectors configuration course to learn how the twinzo coordination system works and how to import your layouts to the digital twin. Localization works for registered devices only.
Devices: https://twinzo.eu/slides/slide/devices-84
Sectors: https://twinzo.eu/slides/slide/sectors-50

Localization data

Localization data can be sent to twinzo API per device or in a batch of devices at once. Each data record must include information about the position, timestamp, sector and device identifier in the case of a batch scenario.

Per device URL: https://api.twinzo.eu/swagger/ui/index#!/Localization/Localization_Localize

Batch URL: https://api.twinzo.eu/swagger/ui/index#!/Localization/Localization_Batch

The only difference in data payload is, that batch localization is wrapping the location contract into the parent object with the device login identifier. Bellow are described data contracts available for 3rd party integration. Other fields that visible in the swagger are only used for twinzo’s RTLS BLE solution and can be ignored. Coordinates must respect the settings of the sector coordinate system described in the sector edit section in the previous chapters.

{

            Timestamp (integer),

            SectorId (integer, optional),

            X (number, optional),

            Y (number, optional),

            Z (number, optional),

            Interval (integer, optional),

            Battery (integer, optional),

            IsMoving (boolean, optional),
            LocalizationAreas(array integer, optional),
            NoGoAreas(array integer, optional)

}