Rechercher des fonctionnalités par ID
Description
Renvoie des fonctionnalités dans une table nommée dans le référentiel défini par son ID. Par défaut, toutes les informations sont incluses dans la réponse. Pour renvoyer un sous-ensemble, vous devez préciser des attributs.
Cette opération renvoie une collection de fonctions JSON qui peut être transmise à une demande d'affichage de carte ou de légende dans Mapping Service.
Format d'URL GET HTTP
Les requêtes GET HTTP se présentent au format suivant :
HTTP GET /tables/tablename/features.rep;[attributes=attname]/key?destinationSrs
Paramètres
Pour plus d'informations sur les types de paramètres répertoriés ci-dessous, reportez-vous à la section Types de données d'URL de requête.
| Paramètre | Type | Requis | Description |
|---|---|---|---|
| tablename | Chaîne | oui | Nom de la table dont renvoyer les fonctions. La table est définie par une balise RegEx pour la table nommée à afficher basée sur l'emplacement de la table nommée dans le référentiel. Le nom de la table nommée est défini entre la portion /tables de l'URL et la portion /features.rep de l'URL. Par exemple, pour renvoyer les fonctions d'une table nommée se trouvant le répertoire /Samples/NamedTables/WorldTable du référentiel, l'URL suivante est utilisée : .../FeatureService/tables/Samples/NamedTables /WorldTable/features.json;... |
| rep | Chaîne | oui | Représentation à renvoyer. La représentation prise en charge est json. |
| attributes=attname | Chaîne | non | Noms d'attribut de la fonction à renvoyer dans la réponse. Par défaut, tous les attributs sont renvoyés. Il est possible de définir plusieurs attributs dans une liste, séparés par des virgules. Il s'agit d'une méthode simple pour limiter la quantité d'informations renvoyées dans la réponse pour n'y inclure que les informations requises. Chaque fonction de la collection de fonctions obtenue ne contient que les attributs précisés. Par exemple, si la table contient quatre attributs, mais que seulement deux d'entre eux sont requis dans la réponse, il est possible de préciser ici le nom de ces deux attributs (séparés par une virgule) et les valeurs des deux autres ne seront pas renvoyées. |
| destinationSrs | Chaîne | non | Système de coordonnées dans lequel renvoyer les géométries obtenues. Le système de coordonnées par défaut est celui des données utilisées (par exemple, epsg:4326). |
| clé | Chaîne | oui | ID de la fonction à renvoyer. Il s'agit soit de l'ID (pour les fichiers .tab), soit de la clé primaire (pour DBMS) de la fonction de la table. |
Résultat
Renvoie des fonctionnalités spécifiées dans une table nommée du référentiel.
{
"type":"FeatureCollection","Metadata":[{"type":"String","name":"Country"},
{"type":"String","name":"Capital"},{"type":"String","name":"Continent"}],
"features":[{"type":"Feature","id":"43","properties":{"Country":"China","Capital":"Beijing","Continent":"Asia"}}]
}
Exemples
Renvoie toutes les métadonnées de fonction de l'enregistrement ID=43 (Chine) pour la table WorldTable du répertoire /Samples/NamedTables du référentiel.
http://www.pbbi.com/rest/Spatial/FeatureService/tables/Samples/NamedTables/WorldTable/features.json/43?destinationSrs=epsg:3857
Renvoie un sous-ensemble (Country, Capital et Continent) des fonctions de l'enregistrement ID=43 (Chine) de la table WorldTable du répertoire /Samples/NamedTables du référentiel, avec des paramètres régionaux de l'anglais américain.
http://www.pbbi.com/rest/Spatial/FeatureService/tables/Samples/NamedTables/WorldTable/features.json;attributes=Country,Capital,Continent/43