Boundaries - Create Or Update

Service:: Azure Data Manager for Agriculture

Version d'API:: 2023-06-01-preview

Crée ou met à jour une ressource de limite.

PATCH /parties/{partyId}/boundaries/{boundaryId}?api-version=2023-06-01-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
boundaryId	path	True	string	ID de la ressource de limite.
partyId	path	True	string	ID de la ressource de partie.
api-version	query	True	string	Version de l’API demandée

En-tête de la demande

Media Types: "application/merge-patch+json"

Nom	Obligatoire	Type	Description
Authorization	True	string	Fournissez un jeton de porteur valide pour les appels d’API autorisés. Notez que vous devrez peut-être effacer le cache de votre navigateur si vous avez essayé des appels non authentifiés avant.

Corps de la demande

Media Types: "application/merge-patch+json"

Nom	Type	Description
area	Measure	Schéma pour le stockage de la lecture et de l’unité de mesure.
bbox	GeoJsonObject: MultiPolygon Point Polygon	GeoJSON (Pour plus d’informations : https://geojson.org/). Remarque : Les coordonnées sont attendues au format [Longitude, Latitude].
centroid	GeoJsonObject: MultiPolygon Point Polygon	GeoJSON (Pour plus d’informations : https://geojson.org/). Remarque : Les coordonnées sont attendues au format [Longitude, Latitude].
description	string minLength: 0 maxLength: 500	Description textuelle de la ressource.
geometry	GeoJsonObject: MultiPolygon Point Polygon	GeoJSON (Pour plus d’informations : https://geojson.org/). Remarque : Les coordonnées sont attendues au format [Longitude, Latitude].
name	string minLength: 0 maxLength: 100	Nom pour identifier la ressource.
parentId	string	ID du parent auquel il appartient.
parentType	BoundaryParentType	Type du parent auquel il appartient. Par exemple, Field, SeasonalField, Zone, Prescription, PlantTissueAnalysis, ApplicationData, HarvestData, TillageData, PlantingData.
properties		Collection de paires clé-valeur qui appartient à la ressource. Chaque paire ne doit pas avoir de clé supérieure à 50 caractères et ne doit pas avoir de valeur supérieure à 150 caractères. Remarque : Un maximum de 25 paires clé-valeur peuvent être fournies pour une ressource et uniquement des valeurs chaîne, numération et datetime (aaaa-MM-jjTHH :mm :ssZ) sont prises en charge.
source	string minLength: 2 maxLength: 100	Source de la ressource.
status	string minLength: 0 maxLength: 100	État de la ressource.
type	string	Indique le type de limite appartenant à un parent.

Réponses

Nom	Type	Description
200 OK	Boundary	Succès
201 Created	Boundary	Date de création
Other Status Codes	ErrorResponse	Erreur En-têtes x-ms-error-code: string

Nom

Type

Description

200 OK

Boundary

Succès

201 Created

Boundary

Date de création

Other Status Codes

ErrorResponse

Erreur

En-têtes

x-ms-error-code: string

Sécurité

Authorization

Fournissez un jeton de porteur valide pour les appels d’API autorisés. Notez que vous devrez peut-être effacer le cache de votre navigateur si vous avez essayé des appels non authentifiés avant.

Type: apiKey
Dans: header

Exemples

Boundaries_CreateOrUpdate

Exemple de requête

HTTP

PATCH /parties/PARTY123/boundaries/BOUNDARY123?api-version=2023-06-01-preview

{
  "parentId": "FIELD123",
  "parentType": "Field",
  "type": "string",
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          73.70457172393799,
          20.545385304358106
        ],
        [
          73.70457172393799,
          20.545385304358106
        ],
        [
          73.70448589324951,
          20.542411534243367
        ],
        [
          73.70877742767334,
          20.541688176010233
        ],
        [
          73.71023654937744,
          20.545083911372505
        ],
        [
          73.70663166046143,
          20.546992723579137
        ],
        [
          73.70457172393799,
          20.545385304358106
        ]
      ]
    ]
  },
  "name": "John Smith's Boundary",
  "description": "Some description"
}

Exemple de réponse

Code d’état:: 200

{
  "parentId": "FIELD123",
  "parentType": "Field",
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          73.70457172393799,
          20.545385304358106
        ],
        [
          73.70457172393799,
          20.545385304358106
        ],
        [
          73.70448589324951,
          20.542411534243367
        ],
        [
          73.70877742767334,
          20.541688176010233
        ],
        [
          73.71023654937744,
          20.545083911372505
        ],
        [
          73.70663166046143,
          20.546992723579137
        ],
        [
          73.70457172393799,
          20.545385304358106
        ]
      ]
    ]
  },
  "type": "string",
  "crs": "WGS84",
  "centroid": {
    "type": "Point",
    "coordinates": [
      73.70711478791443,
      20.54418916247634
    ]
  },
  "bbox": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          73.70448589324951,
          20.541688176010233
        ],
        [
          73.70448589324951,
          20.546992723579137
        ],
        [
          73.71023654937744,
          20.546992723579137
        ],
        [
          73.71023654937744,
          20.541688176010233
        ]
      ]
    ]
  },
  "area": {
    "unit": "Acre",
    "value": 60.405
  },
  "name": "John Smith's Boundary",
  "description": "Some description"
}

Code d’état:: 201

{
  "parentId": "FIELD123",
  "parentType": "Field",
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          73.70457172393799,
          20.545385304358106
        ],
        [
          73.70457172393799,
          20.545385304358106
        ],
        [
          73.70448589324951,
          20.542411534243367
        ],
        [
          73.70877742767334,
          20.541688176010233
        ],
        [
          73.71023654937744,
          20.545083911372505
        ],
        [
          73.70663166046143,
          20.546992723579137
        ],
        [
          73.70457172393799,
          20.545385304358106
        ]
      ]
    ]
  },
  "type": "string",
  "crs": "WGS84",
  "centroid": {
    "type": "Point",
    "coordinates": [
      73.70711478791443,
      20.54418916247634
    ]
  },
  "bbox": {
    "type": "Polygon",
    "coordinates": [
      [
        [
          73.70448589324951,
          20.541688176010233
        ],
        [
          73.70448589324951,
          20.546992723579137
        ],
        [
          73.71023654937744,
          20.546992723579137
        ],
        [
          73.71023654937744,
          20.541688176010233
        ]
      ]
    ]
  },
  "area": {
    "unit": "Acre",
    "value": 60.405
  },
  "name": "John Smith's Boundary",
  "description": "Some description"
}

Définitions

Nom	Description
Boundary	Schéma de la ressource de limite.
BoundaryParentType	Type du parent auquel il appartient. Par exemple, Field, SeasonalField, Zone, Prescription, PlantTissueAnalysis, ApplicationData, HarvestData, TillageData, PlantingData.
Error	Erreur du service Azure AgPlatform.
ErrorResponse	Réponse d’erreur du service Azure AgPlatform. Consultez https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses pour le document de référence ErrorResponse.
GeoJsonObjectType	Type d’objet GeoJSON.
InnerError	Erreur interne contenant la liste des erreurs. Consultez https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object pour le document de référence InnerError.
Measure	Schéma pour le stockage de la lecture et de l’unité de mesure.
MultiPolygon	Géométrie multipolygon.
Point	Géométrie de point.
Polygon	Géométrie de polygone.

Boundary

Object

Schéma de la ressource de limite.

Nom	Type	Description
area	Measure	Schéma pour le stockage de la lecture et de l’unité de mesure.
bbox	GeoJsonObject: MultiPolygon Point Polygon	GeoJSON (Pour plus d’informations : https://geojson.org/). Remarque : Les coordonnées sont attendues au format [Longitude, Latitude].
centroid	GeoJsonObject: MultiPolygon Point Polygon	GeoJSON (Pour plus d’informations : https://geojson.org/). Remarque : Les coordonnées sont attendues au format [Longitude, Latitude].
createdBy	string	Créé par l’ID utilisateur/locataire.
createdDateTime	string (date-time)	Date et heure de création de la ressource, exemple de format : aaaa-MM-ddTHH :mm :ssZ.
crs	string	Système de référence de coordonnées.
description	string minLength: 0 maxLength: 500	Description textuelle de la ressource.
eTag	string	Valeur ETag pour implémenter l’accès concurrentiel optimiste.
geometry	GeoJsonObject: MultiPolygon Point Polygon	GeoJSON (Pour plus d’informations : https://geojson.org/). Remarque : Les coordonnées sont attendues au format [Longitude, Latitude].
id	string	ID de ressource unique.
modifiedBy	string	Modifié par l’ID utilisateur/locataire.
modifiedDateTime	string (date-time)	Date et heure de la dernière modification de la ressource, exemple de format : aaaa-MM-ddTHH :mm :ssZ.
name	string minLength: 0 maxLength: 100	Nom pour identifier la ressource.
parentId	string	ID du parent auquel il appartient.
parentType	BoundaryParentType	Type du parent auquel il appartient. Par exemple, Field, SeasonalField, Zone, Prescription, PlantTissueAnalysis, ApplicationData, HarvestData, TillageData, PlantingData.
partyId	string	ID de partie.
properties		Collection de paires clé-valeur qui appartient à la ressource. Chaque paire ne doit pas avoir de clé supérieure à 50 caractères et ne doit pas avoir de valeur supérieure à 150 caractères. Remarque : Un maximum de 25 paires clé-valeur peuvent être fournies pour une ressource et uniquement des valeurs chaîne, numération et datetime (aaaa-MM-jjTHH :mm :ssZ) sont prises en charge.
source	string minLength: 2 maxLength: 100	Source de la ressource.
status	string minLength: 0 maxLength: 100	État de la ressource.
type	string	Indique le type de limite appartenant à un parent.

BoundaryParentType

Énumération

Type du parent auquel il appartient. Par exemple, Field, SeasonalField, Zone, Prescription, PlantTissueAnalysis, ApplicationData, HarvestData, TillageData, PlantingData.

Valeur	Description
Field
SeasonalField
Zone
Prescription
PlantTissueAnalysis
ApplicationData
PlantingData
TillageData
HarvestData

Error

Object

Erreur du service Azure AgPlatform.

Nom	Type	Description
code	string minLength: 1	Ensemble défini par le serveur de codes d’erreur.
details	Error[]	Tableau de détails sur des erreurs spécifiques qui ont conduit à cette erreur signalée.
innererror	InnerError	Erreur interne contenant la liste des erreurs. Consultez https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object pour le document de référence InnerError.
message	string minLength: 1	Représentation lisible par l’homme de l’erreur.
target	string	Cible de l’erreur.

ErrorResponse

Object

Réponse d’erreur du service Azure AgPlatform. Consultez https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#7102-error-condition-responses pour le document de référence ErrorResponse.

Nom	Type	Description
error	Error	Erreur du service Azure AgPlatform.
traceId	string	ID de trace unique.

GeoJsonObjectType

Énumération

Type d’objet GeoJSON.

Valeur	Description
Point
Polygon
MultiPolygon

InnerError

Object

Erreur interne contenant la liste des erreurs. Consultez https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object pour le document de référence InnerError.

Nom	Type	Description
code	string	Code d’erreur spécifique que fourni par l’erreur contenante.
innererror	InnerError	Erreur interne contenant la liste des erreurs. Consultez https://github.com/Microsoft/api-guidelines/blob/vNext/Guidelines.md#innererror--object pour le document de référence InnerError.

Measure

Object

Schéma pour le stockage de la lecture et de l’unité de mesure.

Nom	Type	Description
unit	string minLength: 1 maxLength: 50	Unité de données.
value	number (double)	Valeur de données.

MultiPolygon

Object

Géométrie multipolygon.

Nom	Type	Description
coordinates	number[] (double)	Obtient ou définit les coordonnées de l’objet GeoJSON. Il doit s’agir d’un tableau de polygones, chaque polygone contient la liste des anneaux linéaires. Pour les polygones avec plus d’un de ces anneaux, le premier DOIT être l’anneau extérieur, et tout autre doit être des anneaux intérieurs.
type	string: MultiPolygon	Type d’objet GeoJSON.

Point

Object

Géométrie de point.

Nom	Type	Description
coordinates	number[] (double)	Obtient ou définit la coordonnée de ce point. Il doit s’agir d’un tableau de 2 ou 3 éléments pour un système 2D ou 3D.
type	string: Point	Type d’objet GeoJSON.

Polygon

Object

Géométrie de polygone.

Nom	Type	Description
coordinates	number[] (double)	Obtient ou définit le type de l’objet GeoJSON. Il doit s’agir d’un tableau de tableaux de coordonnées en anneau linéaires. Pour les polygones avec plus d’un de ces anneaux, le premier DOIT être l’anneau extérieur, et tout autre doit être des anneaux intérieurs.
type	string: Polygon	Type d’objet GeoJSON.