Requêtes de l'API

Le système de surveillance Navitel est un programme avec une interface API ouverte. Une réception/édition/suppression de toute information sur les objets de surveillance ainsi que l'administration des utilisateurs est possible en utilisant les requêtes de l'API. L'autorisation des demandes au système de répartition est effectuée à l'aide des clés API générées dans les paramètres du système de répartition. Pour obtenir cette clé, dans le système d'expédition ouvrez le menu Paramètres et sélectionnez l'onglet API.

1. Général

Pour toutes les requêtes de l'interface API publique JSON-RPC, le préfixe "public-1.0-" est utilisé. Dans la description suivante de toutes les méthodes ce préfixe est implicite. Par exemple, la méthode décrite ci-dessous comme group.get doit être appelée public-1.0-group.get.

Fermer

1.1. Format de requête

Toutes les requêtes sont des requêtes HTTP POST, l'objet JSON de la structure suivante est utilisé comme corps de la requête:

{ "jsonrpc": "2.0", "id": <request-id>, # steadily increasing integer "method": <method-name>, # method name, a string "params": [ .... ] }

  • Le champ id est une demande d'ID en augmentation monotone, un nombre entier

  • Champ de méthode – le nom de la méthode, une chaîne de caracteres

  • Le champ paramètres est une liste d'arguments de méthodes (vides).

Étant donné que l'API JSON-RPC est conçue pour les robots, les requêtes entrantes ne prendront pas en charge les filtres et la pagination maintenant. Tout le filtrage doit être fait du côté du demandeur.

Fermer

1.2. Résultat renvoyé

Toutes les méthodes renvoient le code HTTP et le corps de la réponse. Si la requête est une requête HTTP valide, le code HTTP est renvoyé 200 et le corps de la réponse est l'objet JSON. Si la requête a réussi, l'objet renvoyé contient le champ de résultat.

{ "result": .... }

The value returned in the result field is specific to each request and is described below.

Fermer

1.3. Message d'erreur

Si la requête a été rejetée pour des raisons liées à l'exactitude de la requête HTTP, les codes d'erreur HTTP appropriés sont possibles (par exemple 400, 403, 404, 405, etc.).

Si la requête était syntaxiquement correcte, mais qu'une erreur s'est produite au niveau du Système de Répartition lors de l'exécution, le code HTTP 200 est renvoyé et l'objet JSON renvoyé n'a pas de champ de résultat, mais le champ d'erreur:

{ "error": .... }

Les formats d'erreurs possibles dans l'exécution des requêtes sont décrits ci-dessous.

Fermer

2. Main requests

2.1. Récupérer la liste deVéhicules

Avant d'essayer de récupérer des informations sur les véhicules à l'aide d'une clé API, il est nécessaire d'obtenir la liste de véhicules et leurs caractéristiques d'identification. Pour cela, faites une requête (GET):

https://www.dispatch.navitel.ru/api/1.0/vehicles.xml?apikey=[val]&namefilter=

où "apikey = [val]" est un paramètre nom/valeur typique. La partie "apikey" de ce paramètre est nom, alors que "[val]" est un emplacement pour l'entrée de valeur. Insérez la clé API que vous recevez des paramètres du programme dans la partie valeur de ce paramètre. Par conséquent, une demande appropriée pour la liste de véhicules ressemblerait à ceci:

https://www.dispatch.navitel.ru/api/1.0/vehicles.xml?apikey=00000000000000000000000&namefilter=

De plus, le paramètre du nom du filtre doit figurer à la fin de la liste des véhicules

namefilter=[value]

où "[valeur]" - est la valeur du filtre. Vous pouvez indiquer un nom d'objet particulier sur lequel vous souhaitez obtenir des informations ou vous pouvez laisser le champ vide si vous souhaitez récupérer la liste de tous les objets comme indiqué dans l'exemple ci-dessus.

Après avoir demandé la liste de véhicules, vous recevez une réponse sous forme de code .xml.

<reply> <resulttype="array"> <v i="0"> <group_name>security_group</group_name> <tracker_id>GALILEOSKY:00000000000000000000000000000000</tracker_id> <tracker_type>GALILEOSKY</tracker_type> <vehicle_id>xxxxx-xxxx-xxxx-xxxxxxxxxxxx</vehicle_id> <vehicle_name>Subaru</vehicle_name> </v> <v i="1"> <group_name>security_group</group_name> <tracker_id>GRANIT:00000000000000000000000000000</tracker_id> <tracker_type>GRANIT04</tracker_type> <vehicle_id>xxxxx-xxxx-xxxx-xxxxxxxxxxxx</vehicle_id> <vehicle_name>cardabalet</vehicle_name> </v> </result> </reply>

La réponse comprend des informations sur les véhicules, y compris le groupe/l'entreprise, l'identifiant/ identifiant du pisteur, le type du pisteur, l'identifiant du véhicule et le nom du véhicule. Vous serez en mesure d'utiliser ces données après afin d'identifier les véhicules sur lesquels vous souhaitez récupérer les informations.

Vous pouvez spécifier le format préféré du résultat dans votre requête. Pour cela, ajoutez l'extension appropriée après le mot "véhicules". Extensions possibles: ".xml" ou ".json" (cette fonctionnalité est disponible pour tout type de requête au système de répartition).

Le résultat dans cet exemple sera fourni sous la forme d'un fichier .xml

https://www.dispatch.navitel.ru/api/1.0/vehicles.xml

et dans cet exemple, le résultat sera livré sous la forme de code .json

https://www.dispatch.navitel.ru/api/1.0/vehicles.json

Fermer

2.2. Requête d'authentification

L'API JSON-RPC utilise la clé API pour l'identification qui est le premier paramètre obligatoire de toutes les méthodes sauf apikey.get. Pour obtenir la clé API dans la barre de menu, cliquez sur Paramètres (). Dans la boîte de dialogue qui s'affiche cliquez sur l'onglet API, puis sur Créer.

Fermer

2.3. Requête d'un schéma de création

  • apikey.get - obtenir des clés API par le nom d'utilisateur et le mot de passe

    • Paramètres:

      • identifiant

      • mot de passe

    • Résultat:

      • chaîne de caractère de la clé API

Fermer

2.4. Requêtes d'un groupe

  • group.get – obtenir un liste de groupe.

    • Paramètres:

      • Objet contenant les champs suivants:

        • (facultatif) parent_group_uuid_list – Une liste facultative des groupes parents. Les groupes parents doivent être accessibles à l'utilisateur qui effectue la requête. S'il n'y a pas de liste ou une liste vide dans la requête, le résultat contient tous les groupes de niveau supérieur disponibles pour l'utilisateur, ou tous les groupes, si le paramètre récursif est Vrai.

        • récursif - booléen si la liste des groupes récursive.

    • Résultat:

      • une liste des structures qui décrivent les groupes. Les champs suivants dans les structures sont documentés:

        • obligatoire:

          • uuid - UUID du groupe

          • nom —

        • non obligatoire:

          • parent_group_uuid - UUID du groupe parent, si le groupe parent existe et que l'API est disponible pour l'utilisateur

          • des limits - un objet contenant une liste de contraintes, si des contraintes sont spécifiées pour un groupe (le groupe est une société):

            • max_users - Nombre maximal d'utilisateurs, en entier ou aucun, si aucune limite n'est spécifiée

            • max_vehicles - Nombre maximal de véhicules, en entier ou aucun, si aucune limite n'est spécifiée

            • valid_until - Période de validité de la licence, ligne sous format ISO-8601 ou aucune si aucune limite n'est spécifiée

  • group.create - Création de groupe.

    • Paramètres:

      • groupes - Une liste d'objets décrivant les groupes créés. Dans chaque objet, les mêmes champs sont documentés en tant que champs group.get. Ne spécifiez pas le groupe UUID, le champ sera ignoré.

    • Résultat

      • Liste UUID des groupes créés.

  • group.edit - modifie les champs sélectionnés dans les groupes existants.

    • Paramètres:

      • group_fields - Un dictionnaire d'objets décrivant des champs de groupe modifiables. Les clés du dictionnaire sont des groupes UUID. Les champs des objets correspondent aux champs de group.get. Les champs qui ne sont pas spécifiés dans l'objet ne sont pas modifiés. L'absence du groupe avec l'UUID spécifié au moment de la demande est une erreur.

    • Le résultat est absent

  • group.delete - Suppression de groupes.

    • Paramètres:

      • uuid_list - Liste des UUID des groupes supprimés. L'absence d'un groupe avec l'UUID spécifié au moment de la requête n'est pas considérée comme une erreur.

    • Le résultat est absent

Fermer

2.5. Requêts de surveillance d'objects

  • vehicle.get: Réception d'une liste d'appareils de suivi pour le groupe spécifié.

    • Paramètres:

      • parent_group_uuid - UUID du groupe.

    • Résultat:

      • une liste des structures décrivant les objets de surveillance dans ce groupe:

        • obligatoire:

          • uuid - UUID de l'objet de surveillance

          • nom - Suivi du nom de l'objet

          • parent_group_uuid

          • tracker_type – Chaîne de caractères identifiant le type de tracker depuis une liste fixe de lignes (énum.); Actuellement, il n'y a qu'un seul élément dans la liste - OLYMPSTROY. À l'avenir, la liste des trackers supportés par cette API sera étendue

          • tracker_identifier – Chaîne de caractères ou ensemble de chaînes de caractères identifiant une instance d'un tracker de ce type.
            À noter: actuellement il n'y a pas de trackers qui nécessitent un tableau de lignes, plus tard ils seront explicitement listés.

        • non obligatoire:

          • display_icon - Numéro de l'icône. Actuellement, les nombres de 0 à 14 sont standardisés.

          • display_color - Icônes de couleur, une ligne sous format CSS hexadecimalcolors (#RRGGBB).

        • L'appelant doit traiter correctement la présence de nouveaux champs non documentés.

  • vehicle.create - créer de nouveaux véhicules en tant que des objets.

    • Paramètres:

      • véhicules - Liste des structures décrivant les objets de surveillance en cours de création. L'UUID n'est pas spécifié (défini par le serveur). Les champs valides correspondent aux champs du vehicle.get. Les champs obligatoires sont:

        • nom

        • parent_group_uuid

        • tracker_type

        • tracker_identifier

    • Résultat:

      • liste des UUID des objets de surveillance créés ou une erreur si au moins un des objets demandés ne peut pas être créé.

  • vehicle.edit - Modification des propriétés des objets de surveillance.

    • Paramètres:

      • vehicle_fields - un dictionnaire dont les clés sont des UUID des objets de surveillance et des valeurs - des structures décrivant des changements dans des objets. Les champs valides correspondent aux champs du vehicle.get. Les champs qui ne sont pas spécifiés dans la requête ne sont pas modifiés. L'impossibilité pour une raison ou une autre d'éditer au moins un des objets listés entraîne une erreur de la requête entière, aucune modification n'est appliquée.

    • Résultat:

      • Non disponible si l'opération s'est terminée correctement ou si un message d'erreur s'affiche dans le format spécifié.

  • vehicle.delete - Effacement des véhicules.

    • Paramètres:

      • uuid_list - Liste UUID des objets de surveillance supprimés. L'absence d'un objet avec l'UUID spécifié au moment de la demande n'est pas considérée comme une erreur.

    • Résultat: Non, si l'opération a réussi ou un message d'erreur dans le format spécifié.

Fermer

2.6. Rôle des requêtes

  • role.get - récupère la liste des rôles pour le groupe spécifié.

    • Paramètres:

      • parent_group_uuid.

    • Résultat:

      • Liste des structures décrivant les rôles dans ce groupe. Dans chaque structure, les champs suivants sont documentés:

        • uuid - rôle UUID

        • nom - nom du rôle

Fermer

2.7. Requêtes de l'utilisateur

  • user.get - récupère une liste d'utilisateurs pour le groupe spécifié.

    • Paramètres:

      • parent_group_uuid

    • Résultat:

      • Liste des structures décrivant les utilisateurs de ce groupe. Les champs sont décrits ci-dessus.

  • user.create - créer des utilisateurs.

    • Paramètres:

      • Utilisateurs - Liste de structures décrivant les utilisateurs en cours de création. UUID n'est pas spécifié (défini par le serveur).

    • Résultat:

      • Liste UUID des utilisateurs créés.

  • user.edit - Modification des champs sélectionnés des utilisateurs existants.

    • Paramètres:

      • user_fields - un dictionnaire de structures décrivant les champs modifiables de l'utilisateur. Les clés du dictionnaire sont des utilisateurs UUID. Les champs non définis doivent être modifiés. L'absence d'un utilisateur avec l'UUID spécifié au moment de l'exécution de la requête est une erreur.

    • Le résultat est absent

  • user.setPassword - définit le mot de passe de l'utilisateur.

    • Paramètres:

      • uuid - UUID de l'utilisateur

      • mot de passe – le nouveau mot de passe

  • user.delete - supprime les utilisateurs créés.

    • Paramètres:

      • uuid_list - Liste des UUID pour supprimer des utilisateurs. L'absence au moment de l'exécution d'une demande d'utilisateur avec l'UUID spécifié n'est pas considérée comme une erreur.

    • Le résultat est absent

Fermer

3. Demandes de création de feuilles de voyage

3.1. Récupération des données d'un rapport de voyage

La requête JSON-RPC est la suivante:

{ "jsonrpc": "2.0", "id": <requestId>, "method": "public-1.0-report.trip.get", "params": [ apiKey, { "startTime": <timestamp>, "endTime": <timestamp>, "lang": <langId>, "vehicles": [ "<uuid1>", "<uuid2>",... ] } ] }

Le format de la réponse:

{ "id": <requestId>, // request ID "result": { "startTime": <timestamp>, "endTime": <timestamp>, "address_fields": [ "country", "region", "parish", "city", "district", "street", "building" ], "headers": [ "moveTime", "startTime", "origin", "endTime", "destination", "maxSpeed", "kilometresTravelled", "totalFuelConsumption" ], "vehicles": [ { "uuid": "<uuid>", // vehicle UUID "name": "<name>", "rows": [ [ <interval>, <timestamp>, <address>, <timestamp>, <address>, <kmh>, <km>, <litres> ], ... ] }, { "uuid": "<uuid>", // vehicle UUID "name": "<name>", "rows": [ ... ], }... ] } }

Fermer

3.2. Récupération des Informations de Surveillance

Une requête régulière au système de répartition est essentiellement une ligne constituée d'une URL de base et d'un ensemble de paramètres de requête. L'URL de base doit toujours être en tant que telle (sauf lors de la récupération de la liste des véhicules):

https://www.dispatch.navitel.ru/api/1.0/vehicleinfo.xml?

Les paramètres de la requête sont une ligne de paires nom/valeur, chaque paire étant séparée par une esperluette ("&"). Ils doivent être placés juste après le point d'interrogation de l'URL de base. Chaque paramètre a le nom/valeur suivant:

field=[value]

où "[field]" est le nom du paramètre et "[value]" est la valeur du paramètre. Il y a plusieurs noms disponibles pour la saisie: "id", "nom", "imei", "heure", "quoi ", "apikey". L'entrée est sensible à la casse.

Une demande devrait normalement contenir les paramètres énumérés ci-dessous:

1. Un ensemble d'identifications de véhicule. Tout véhicule est défini par une des trois identifications possibles: "id", "nom", "imei". L'identification est essentiellement une ligne de ce type:

id=[vehicle_static_id_0]

où "[vehicle_static_id_0]" est l'identifiant du véhicule que vous pouvez obtenir en demandant la liste des véhicules.

Puisque les identifications ne sont que de simples paramètres nom/valeur, vous pouvez en utiliser plusieurs pour recevoir des informations sur plusieurs véhicules à la fois. Comme les autres paramètres, les identifications doivent être séparées par une esperluette.

id=[vehicle_static_id_0]&id=[vehicle_static_id_0]

Vous pouvez utiliser différents types d'identifications lorsque vous spécifiez des véhicules dans la demande. Par exemple:

id=[vehicle_static_id_0]&name=[vehicle_name]&imei=[vehilce_imei]&id=[vehicle_static_id_N]

S'il vous arrive d'entrer différentes identifications du même véhicule, ne vous inquiétez pas, le véhicule sera toujours affiché une seule fois.

2. Clé de l'API:

apikey=[val]

où "[val]" est la clé API que vous pouvez recevoir dans les paramètres du système de répartition.

3. Un ensemble de paramètres nécessaires, chaque paramètre étant séparé par une esperluette ("&"):

field=[value]&field=[value]&field=[value]

où "[field]" est le nom du paramètre, et "[value]" est la valeur du paramètre. Utilisez les tableaux ci-dessous comme guide pour les noms et valeurs de paramètres corrects.

Fermer

3.3. Paramètres pour une Période de Temps Fixe T

À partir de maintenant, vous devriez déjà être prévenu(e)s de la façon d'inclure des paramètres d'identification et d'API dans la requête. Mais il y a aussi le paramètre "quoi" qui est utilisé pour demander des informations sur un indicateur spécifié dans la valeur du bloc de paramètres.

Dites, si je voulais recevoir des informations sur la vitesse d'un objet à ce moment particulier, je voudrais utiliser le paramètre

what=speed_kmh

alors, la requete complète serait comme telle:

https://www.dispatch.navitel.ru/api/1.0/vehicleinfo.xml?apikey=00000000000000000000000&name=NaviCar&what=speed_kmh

Dans l'exemple ci-dessus, j'ai demandé des informations sur la vitesse du véhicule nommé "NaviCar" et utilisé le code d'accès API "00000000000000000000000" pour accéder au système de répartition. De même, vous pouvez demander des informations sur les paramètres répertoriés dans le tableau ci-dessous. Le nom de tous les paramètres de cette table est "quoi"; la valeur doit être extraite de la colonne "Valeur" de la table.

Description du paramètre

Value

ignition

ignition

latitude, longitude

lat_deg, lon_deg

vitesse

speed_kmh

direction du mouvement

direction_deg

nombre de satellites, hdop

satellite_count, hdop

hauteur

altitude_m

paramètres gsm (mcc,mnc,lac etc)

mcc, mnc, lac, cellid, signal_strength, timing_advance

tension d'alimentation externe

external_power_mv

tension interne de la batterie d'alimentation

battery_power_mv

température du tracker

temperature_c

lectures de l'accéléromètre (x, y, z)

acceleration_x_ms2, acceleration_y_ms2, acceleration_z_ms2

bouton d'alarme

alarm_on

température du liquide de refroidissement

coolant_temp_c

taux de rotation du moteur

engine_rpm

niveau de carburant (%)

fuel_percent

kilométrage

mileage_km

carburant total consommé

total_fuel_consumed_l

niveau du carburant (canister)

can_fuel_l

temps de fonctionnement du moteur (canister)

mhours

vitesse (canister)

can_speed_kmh

niveau de carburant (calculé, converti, etc.)

fuel_l

entrées analogiques

analog_input

entrées numériques

digital_input

centrée du canister

can_input

entrée de fréquence

frequency_hz

compteurs d'impulsions

pulse_counter_pcs

téléchargement de l'axe

axle_load_kg

version d'enregistrement du canister

can_log_version

taille de paquet reçu en octets

in_chunk_size

nombre de paquets reçus

in_package_count

taille de la réponse de service en octets

out_chunk_size

nombre de réponses du serveur

out_package_count

liste des valeurs d'entrée de fil

one_wire_input

liste des valeurs d'entrée du capteur

sensor_input

liste des valeurs d'entrée analogiques

voltage_mv

Fermer

3.4. Spécification de l'heure

Si aucun paramètre de l'heure n'est spécifié dans la requête, le retour inclut des données sur l'instant actuel. Pour spécifier un moment distinct dans la requête, un paramètre de l'heure spécial est utilisé:

time=[val]

où "[val]" est un moment spécifié dans le respect de la norme ISO 8601 (voir https://en.wikipedia.org/wiki/ISO_8601). L'entrée est sensible à la casse.

Selon cette norme, le format de l'heure a la forme "AAAA-MM-JJThh: mm: ss". Par conséquent, l'entrée doit être en tant que telle:

time=2016-07-12T12:00:00

où la date est indiquée comme étant le 12 juillet 2015 et l'heure est 12:00:00.

Vous pouvez également spécifier une fuseau d'horaires dans la valeur du paramètre time en ajoutant le nom de la fuseau d'horaires à la fin de la valeur (par exemple, l'heure de Moscou ou "Asia/Novosibirsk")

time=2016-07-12T12:00:00MSK

Pour indiquer le fuseau d'horaires UTC, ajoutez simplement "Z" à la fin de la valeur du paramètre.

Vous pouvez également ajuster un fuseau d'horaires en déplaçant simplement l'heure "hh: mm" vers l'arrière ou vers l'avant jusqu'à ce que vous atteigniez le fuseau d'horaires nécessaire

time=2016-07-22T12:00:00+03:00

Fermer

3.5. Spécification d'Intervalle de Temps

Si vous souhaitez spécifier un intervalle de temps, indiquez 2 instants comme indiqué dans le chapitre précédent et séparez-les avec le symbole barre oblique.

time=[val1]/ [val2]

où "[val1]" - est le début de l'intervalle de temps, tandis que "[val2]" est la fin.

Par exemple:

time=2015-07-12T12:00:00/2015-07-15T15:52:01

Cela signifie que l'intervalle de temps commence le 12 juillet 2015 à 12:00:00 et se termine le 15 juillet 2015 à 15:52:01.

Il est également possible de créer un intervalle de temps dans le formulaire "IsoTime/durée" où la durée de l'intervalle est définie comme "PxxYxxMxxDTxxHxxMxxS (le préfixe P est suivi de la durée de l'intervalle, sensible à la casse). Si une intervalle de temps est défini la plus grande valeur de cet intervalle est prise pour les paramètres du groupe A.

Le tableau ci-dessous fournit la liste des paramètres "what" qui doivent toujours être utilisés avec les paramètres d'intervalle de temps:

Description du paramètre

Value

durée du mouvement

moveTime

durée de l'arrêt

stopTime

arrêt sans données

lostSignalTime

kilométrage

kilometresTravelled

consommation de carburant en litres

totalFuelConsumption

vitesse moyenne

avgMoveSpeed

top vitesse

maxSpeed

point initial

origin

point de destination

destination

fin/début du niveau de carburant

endFuelLevel, startFuelLevel

consommation de carburant (litres) par /100km

fuelPer100Km

calcul de carburant/de vidange (événements)

fuelingCount, fuelDrainCount

Calcul de carburant / vidange (litres)

totalFueling, totalFuelDrain

Fermer

4. Opérations avec des calques

4.1. Récupération de la liste de couches dans les groupes

{ "jsonrpc": "2.0", "id": , "method": "public-1.0-layer.get", "params": [ "", ["", ""...] // list of group's UUID ] }

Une réponse au résultat positif:

{ "result": [ <object list> ] }

Chaque couche est décrite par la structure suivante:

{ "uuid": "", "external_id": ", // non-obligatory ID of layer in external system "parent_group_uuid": "", "name": ", "visibility": , "priority": }

Fermer

4.2. Mise à jour des données en couches

Cette méthode efface la couche spécifiée dans le paramètre "", puis remplit cette couche avec une liste de nouveaux objets.

Format de la requête:

{ "jsonrpc": "2.0", "id": , "method": "public-1.0-layer.objects.replace", "params": [ "", "", [ <object list> ] ] }

Chaque objet a la structure suivante:

{ "name": "", "geometry": "", // currently supported only one type POINT "icon_url": "", "color_id": , // currently only colors from 1 to 9 are standardized "geo_object_fields": { // non-obligatory dictionary of additional object features "": ,... } }

Réponse au résultat positif:

{ "result": [ "", ""... ] // list of created object's UUIDs. }

Dans la réponse, le numéro de série de l'UUID correspond au numéro de l'objet dans la demande. Toutes les modifications demandées sont appliquées de manière atomique: ou toutes sont appliquées, ou l'état des couches n'a pas changé.

Fermer

4.3. Ajouter un objet dans une couche

Similaire à "public-1.0-layer.objects.replace", mais sans supprimer au préalable les objets existants dans la couche.

Requete:

{ "jsonrpc": "2.0", "id": , "method": "public-1.0-layer.objects.create", "params": [ "", "", [ <object list> ] ] }

Chaque objet a la structure suivante:

{ "name": "", "geometry": "", // currently supported only one type POINT "icon_url": "", "color_id": , // currently only colors from 1 to 9 are standardized "geo_object_fields": { // non-obligatory dictionary of additional object features "": ,... } }

Réponse au résultat positif:

{ "result": [ "", ""... ] // list of created object's UUIDs. }

Dans la réponse, le numéro de série de l'UUID correspond au numéro de l'objet dans la requête. Toutes les modifications demandées sont appliquées de manière atomique: ou toutes sont appliquées ou l'état des couches n'a pas changé.

Fermer

4.4. Modification d'objets dans les couches

Similaire à "public-1.0-layer.objects.replace", mais les objets énumérables identifiés par le champ "uuid" doivent déjà exister dans la couche. La spécification de propriétés d'objet autres que "uuid" est facultative. Les champs de l'objet qui ne sont pas spécifiés dans la requête ne sont pas modifiés dans le système de répartition.

Requête:

{ "jsonrpc": "2.0", "id": , "method": "public-1.0-layer.objects.create", "params": [ "", "", [ <object list> ] ] }

Chaque objet a la structure suivante:

{ "uuid": "", // All the following fields are optional, if the field is not specified it will not be edited. "name": "", "geometry": "", // currently supported only one type POINT "icon_url": "", "color_id": , // currently only colors from 1 to 9 are standardized "geo_object_fields": { // non-obligatory dictionary of additional object features "": ,... } }

Fermer

5. Description des types de données

<RequestId> - ID unique de demande-réponse, entier.

<LangId> est le code du langage de réponse préféré, la langue est un code de langue ISO 639 en minuscules, à deux lettres.

<Interval> - une intervalle de temps en secondes, en entier.

<Timestamp> - le nombre de secondes écoulées depuis le 01/01/1970 00:00 UTC

<Address> est un tableau dont les éléments sont des chaînes correspondant aux composants d'adresse listés dans le champ address_fields.

<Kmh> - vitesse, km / h, nombre à virgule.

<Km> - distance, km, nombre à virgule.

<Litres> - volume, l, nombre à virgule.

Fermer