Obtenir des données depuis le service Genetec Patroller™ Simple Host

Vous pouvez récupérer des données de lectures et d'alertes du service Genetec Patroller™ Simple Host à l'aide de fonctions prédéfinies. Vous pouvez également envoyer les entrées Nouveaux véhicules recherchés en mode push et générer des alertes.

Six fonctions définies dans le contrat Simple Host sont disponibles pour obtenir des données depuis/envoyer des données vers Genetec Patroller™ :

GetReadData
GetReadIds
GetLatestXGuidAndPlateNumber
GetHitData
AddNewWanted
RaiseHit

La définition de chaque balise XML renvoyée par les appels de fonctions est présentée dans Description des balises XML pour Genetec Patroller™ Simple Host.

Description des fonctions Simple Host

GetReadData: La méthode GetReadData renvoie toutes les informations pertinentes concernant une lecture de plaque. Voici un exemple de code XML renvoyé par un appel à cette fonction.

GetReadIds: La méthode GetReadIds renvoie les identifiants uniques (GUID) de toutes les lectures entre les paramètres de début et de fin.


<AutoVuReturn>
    <Vehicle>
        <PlateNumber>ABC123</PlateNumber>
        <TimeStamp>12/3/2013 8:15:08 AM</TimeStamp>
        <UnitName>Unit 1</UnitName>
        <UserName>Default user</UserName>
        <Attributes 
            State="QC" CameraOrientation="3" ReadType="1" />
    </Vehicle>
</AutoVuReturn>

GetLatestXGuidAndPlateNumber: La méthode GetLatestXGuidAndPlateNumber renvoie une chaîne XML qui contient les dernières alertes déclenchées. Voici un exemple de code XML renvoyé par un appel à cette fonction.

                     
<AutoVuReturn>
    <Hit>
        <HitID>B117F607-8367-40BD-BB18-99230A4F0569</HitID>
        <Vehicle>
            <PlateNumber>YUI765</PlateNumber>
        </Vehicle>
    </Hit>
    <Hit>
        <HitID>BB5B4B67-5080-4E0A-AB0B-0159CF646459</HitID>
        <Vehicle>
            <PlateNumber>420RFA</PlateNumber>
        </Vehicle>
    </Hit>
    <Hit>
        <HitID>E86DFD41-BA15-446A-B902-83A51EF872E6</HitID>
        <Vehicle>
            <PlateNumber>9476073</PlateNumber>
        </Vehicle>
    </Hit>
    <Hit>
        <HitID>FE8B1F23-B8D6-4025-A9CE-6030F34FE097</HitID>
        <Vehicle>
            <PlateNumber>6549330</PlateNumber>
        </Vehicle>
    </Hit>
</AutoVuReturn>

GetHitData: La fonction GetHitData renvoie toutes les données relatives à une alerte, dont les images codées en 64 bits associées à l'alerte. Cette fonction utilise le GUID de l'alerte pour récupérer les données d'alerte. Le GUID est récupéré avec la fonction GetLatestXGuidAndPlateNumber. Voici des exemples de code XML renvoyé par cette fonction.
Exemple de code XML pour une alerte de liste de véhicules recherchés


<AutoVuReturn>
    <Hit>
        <HitID>7A17CA80-79CC-46FF-8480-AEE4C71E0F2F</HitID>
        <HitCategory>Scofflaw</HitCategory>
        <HotlistPlateState>QC</HotlistPlateState>
        <Vehicle>
            <PlateNumber>QAZWSX</PlateNumber>
            <TimeStamp>4/4/2020 3:13:28 PM</TimeStamp>
            <UnitName>Unit 1</UnitName>
            <UserName>Default user</UserName>
            <Location>
                <Latitude>-73.6065188673537</Latitude>
                <Longitude>45.5278538806699</Longitude>
                <Heading>18.3796565908587</Heading>
                <Address>Av Viaduc Rosemont-Van Horne</Address>
                <ToStreet>Rue St-Urbain</ToStreet>
                <FromStreet>Rue Viaduc Rosemont-Van Horne</FromStreet>
            </Location>
            <Image>
                <Purpose>LPR</Purpose>
                <CameraName>Left LPR</CameraName>
                <Data>*</Data>
            </Image>
            <Image>
                <Purpose>Context</Purpose>
                <CameraName>Left context</CameraName>
                <Data>*</Data>
            </Image>
            <Attributes ReadType="1" />
        </Vehicle>
        <Attributes HitType="Hotlist" />
    </Hit>
</AutoVuReturn>

Exemple de code XML pour alerte de dépassement horaire.

Une alerte de dépassement horaire contient un deuxième véhicule puisque deux lectures de RAPI sont nécessaires pour déclencher une alerte de dépassement horaire.

                         
<AutoVuReturn>
    <Hit>
        <HitID>E20AB636-C516-4CAD-BD91-72FFF07582B4</HitID>
        <Vehicle>
            <PlateNumber>123456</PlateNumber>
            <TimeStamp>4/4/2020 3:07:52 PM</TimeStamp>
            <UnitName>Unit 1</UnitName>
            <UserName>Default user</UserName>
            <Location>
                <Latitude>-73.6189690674709</Latitude>
                <Longitude>45.5159273241462</Longitude>
                <Heading>57.7012353085265</Heading>
                <Address>1726, Av Van Horne</Address>
                <ToStreet>Av Hartland</ToStreet>
                <FromStreet>Av Antonine Maillet</FromStreet>
            </Location>
            <Image>
                <Purpose>LPR</Purpose>
                <CameraName>Left LPR</CameraName>
                <Data>*</Data>
            </Image>
            <Image>
                <Purpose>Context</Purpose>
                <CameraName>Left context</CameraName>
                <Data>*</Data>
            </Image>
            <Attributes ReadType="5"                             ZoneName="Zone A BF always 2 mins"                             ZoneColor="-32640" NumberOfViolation="1" />
        </Vehicle>
        <Vehicle2>
            <PlateNumber>123456</PlateNumber>
            <TimeStamp>4/4/2020 3:03:08 PM</TimeStamp>
            <UnitName>Unit 1</UnitName>
            <UserName>Default user</UserName>
            <Location>
                <Latitude>-73.6189097563445</Latitude>
                <Longitude>45.5159931789884</Longitude>
                <Heading>57.7012655931207</Heading>
                <Address>1722, Av Van Horne</Address>
                <ToStreet>Av Hartland</ToStreet>
                <FromStreet>Av Antonine Maillet</FromStreet>
            </Location>
            <Image>
                <Purpose>LPR</Purpose>
                <CameraName>Left LPR</CameraName>
                <Data>*</Data>
            </Image>
            <Image>
                <Purpose>Context</Purpose>
                <CameraName>Left context</CameraName>
                <Data>*</Data>
            </Image>
            <Attributes ReadType="5"                             ZoneName="Zone A BF always 2 mins"                             ZoneColor="-32640" />
        </Vehicle2>
        <Attributes HitType="Overtime"                   VehicleOvertimeGUID=                        "56cef816-2025-4053-a0d1-341f8346b445" />
    </Hit>
</AutoVuReturn>

Exemple de code XML pour une alerte de permis


<AutoVuReturn>
    <Hit>
        <HitID>5F20ACE3-192A-4D3B-BD82-F89B1A995E2A</HitID>
        <Vehicle>
            <PlateNumber>JHJ</PlateNumber>
            <TimeStamp>4/4/2020 2:18:04 PM</TimeStamp>
            <UnitName>Unit 1</UnitName>
            <UserName>Default user</UserName>
            <Location>
                <Latitude>-87.6554201136705</Latitude>
                <Longitude>41.7224790875399</Longitude>
                <Heading>-88.0852803934929</Heading>
                <Address>9438, S Throop St</Address>
                <ToStreet>W 95th St</ToStreet>
                <FromStreet>W 94th St</FromStreet>
            </Location>
            <Image>
                <Purpose>LPR</Purpose>
                <CameraName>Left LPR</CameraName>
                <Data>*</Data>
            </Image>
            <Image>
                <Purpose>Context</Purpose>
                <CameraName>Left context</CameraName>
                <Data>*</Data>
            </Image>
            <Attributes ZoneColor="0" ReadType="3"                             ZoneName="Zone1" PolygonName="Zone1" />
        </Vehicle>
        <Attributes HitType="Permit" />
    </Hit>
</AutoVuReturn>

AddNewWanted

La fonction AddNewWanted permet d'envoyer un enregistrement Nouveau véhicule recherché au véhicule de patrouille. Le numéro de plaque ne doit pas être vide ni comporter moins de 10 caractères. La durée d'expiration doit être supérieure à zéro.

L'exemple suivant envoie à Genetec Patroller™ le numéro de plaque de Nouveau véhicule recherché ABC123 de la province du Québec, valable 10 jours.

service.AddNewWanted("ABC123", "QC", 10);

RaiseHit

Cette fonction sert à envoyer une alerte au véhicule de patrouille. Utilisée lorsque la logique qui veut qu'une lecture génère une alerte est exécutée par une application externe à Genetec Patroller™.

Cette fonction nécessite les paramètres suivants en entrée :

readGuid

GUID correspondant au GUID de lecture préexistant dans Genetec Patroller™. Cette valeur peut être obtenue à l'aide des fonctions Simple Host GetReadIDs et GetReadData.

hitPlateNumber

Numéro de plaque provenant de la liste ayant déclenché l'alerte. Par exemple, si l'application externe prend en charge les correspondances partielles, la lecture peut être égale à ABC123 et hitPlateNumber peut être égal à AB8123.

hitPlateState

État, pays ou province associé à l'alerte. Ce paramètre peut rester vide.

catégorie

Catégorie d'alerte déterminée par l'application tierce qui recherche les correspondances.

hitColor

La couleur de l'alerte. La valeur doit correspondre aux couleurs prédéfinies dans l'interface de Simple Host.

attributeKeyValuePairs

Ce paramètre permet d'associer différents attributs, ainsi que leur valeur, à une alerte. Ces attributs et valeurs (combinaisons clé-valeur) doivent être présentés au format JSON (JavaScript Object Notation).

L'exemple suivant présente plusieurs attributs et valeurs possibles au format JSON :


{"Model":"Honda",
 "Year":"2020",
 "Name":"Doe",
 "Surname":"John",
 "License No.":"123456789"}

Obtenir des données depuis le service Genetec Patroller™ Simple Host - Genetec Patroller™ 6.6

Guide de l’administrateur Genetec Patroller™ 6.6

Description des fonctions Simple Host