Géométries des objets

Principe

Ce web service retourne la géométrie des objets, au format geojson, filtrés par couche et optionnellement par bounding box. Disponible uniquement pour les couches de type vecteurs (cf. Le web service de liste des couches).

Disponibilité

Ce web service est disponible avec Geoconcept Web en passant le paramètre services.activate.getFeatures à true (cf. section paramètres avancés).

V1

Paramètres / propriétés

En entrée

paramètre description optionnel défaut

layerId

Identifiant de la couche vecteur

non

bbox

La bounding box de filtre, elle doit être dans même projection que les objets.

oui

En sortie

paramètre type min/max description

message

string

1/1

"Get geojson features"

status

string

1/1

"OK" ou "ERROR"

result

array

0/illimité

Résultat

Résultat (result)

paramètre type min/max description

id

string

1/1

null

geojson

string

1/1

geojson

pagination

string

1/1

null

sort

string

1/1

null

distinctValues

string

1/1

null

fields

array

0/illimité

Description des champs utilisés dans le geojson

Description des champs utilisés dans le geojson (fields)

paramètre type min/max description

name

string

1/1

Libellé du champ de la base de données.

alias

string

1/1

Alias du champ.

type

string

1/1

Typage de champ.

REST (POST)

Requête

Requête 

http://<server>/<webapp>/api/lbs/layers/getFeatures

Data (JSON) 

{
   "layerId":"136",
   "bbox":"-262000,5982000,-258000,5988000"
}

Réponse

La réponse est toujours encodée en UTF-8.

Format JSON 

{
   "message":"Get geojson features",
   "status":"OK",
   "result":{
      "id":null,
      "geojson":"{[geojson]}",
      "pagination":null,
      "sort":null,
      "distinctValues":null,
      "fields":[
         {
            "name":"co_insee_com",
            "alias":"city_code",
            "type":"Integer"
         },
         {
            "name":"lb_com",
            "alias":"city",
            "type":"String"
         },
         {
            "name":"lb_voie_ext",
            "alias":"street",
            "type":"String"
         },
         {
            "name":"va_no_voie",
            "alias":"number",
            "type":"Integer"
         }
      ]
   }
}

Geojson 

{
   "type":"FeatureCollection",
   "features":[
      {
         "type":"Feature",
         "geometry":{
            "type":"Point",
            "coordinates":[
               -258650.09,
               5982645.79
            ]
         },
         "properties":{
            "co_insee_com":"44132",
            "lb_com":"PORNICHET",
            "lb_voie_ext":"AVENUE DE BONNE SOURCE",
            "va_no_voie":"150"
         },
         "id":"gw_sample_point.A5U8T4"
      },
      [...]
      }
   ]
}

Retours possibles

Cas d’une absence de layer 

{"message":null,"status":"ERROR","result":{"id":null,"geojson":null,"pagination":null,"sort":null,"distinctValues":null,"fields":null}}

cas d’une mauvaise Bounding box 

{"message":"Error to get feature source : gw_sample_point","status":"ERROR","result":{"id":null,"geojson":null,"pagination":null,"sort":null,"distinctValues":null,"fields":null}}