Rechercher dans une table des fonctions à un point donné
Description
Recherche dans une table nommée du référentiel des fonctions qui se trouvent à un point donné, avec une certaine tolérance. Vous pouvez renvoyer l'ensemble des données d'attribut ou certaines données d'attribut spécifiques et trier les données renvoyées en fonction d'un attribut. Voici quelques règles de base pour la méthode searchAtPoint :
- Renvoie une collection de fonctions ainsi que les attributs.
- Renvoie la distance dans l'unité précisée dans la tolérance.
- Renvoie les résultats, par défaut, du plus proche au plus éloigné.
- L'attribut q doit être le type de requête searchAtPoint.
- Si vous précisez les paramètres de matrice attribute et orderBy, vous pouvez en répertorier plusieurs dans une liste, séparés par des virgules.
- Le rayon de tolérance par défaut est de 300 mètres.
- Si vous utilisez le paramètre de matrice orderBy, vous devez préciser le sens de tri D (descendant) ou A (Ascendant).
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.
Flux d'autorisation ACL
Pour rechercher dans une table nommée du référentiel des fonctions situées à un point spécifié, dans une certaine tolérance, l'utilisateur (ou les rôles auxquels il appartient) aura besoin de l'autorisation Execute sur les tables nommées de la manière suivante :
- « EXECUTE » pour le type d'entité « Location Intelligence.Named Resources »
Format d'URL GET HTTP
Les requêtes GET HTTP se présentent au format suivant :
HTTP GET /tables/tablename/features.rep;[attributes=attname];[orderBy=attname dir]
&q=searchAtPoint&point=point,srs&[tolerance=distance unit]
&destinationSrs&[geometryAttributeName=geomname]
&[page=pagenumber]&[pageLength=pagelength]
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 | Obligatoire | Description |
|---|---|---|---|
| tablename | Chaîne | oui | Nom de la table dont renvoyer les métadonnées. 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 /metadata.rep de l'URL. Par exemple, pour renvoyer les métadonnée 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/metadata.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 table à 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. |
| orderBy=attname dir | Chaîne | non | Nom d'attribut et sens de tri des résultats renvoyés. Par défaut, les résultats sont triés du plus proche au plus éloigné, en fonction de la distance par rapport au point défini. Si vous précisez un attribut pour trier les résultats, vous devez inclure le nom d'attribut et le sens de tri (A pour ascendant (éloigné vers proche) ou D pour descendant (proche vers éloigné)). |
| q=searchAtPoint | Chaîne | oui | Méthode de requête à exécuter. Il doit s'agir de searchAtPoint. |
| point=point,srs | Chaîne | oui | Point utilisé comme point de départ de la recherche. Le point doit inclure les positions x/y et le système de référence spatiale de la géométrie. Par exemple : point=-75.651157,45.374245,EPSG:4326 |
| tolerance=distance unit | Chaîne | non | Distance faisant l'objet de la recherche autour du point. Par défaut, la tolérance est de 300 mètres. Lorsqu'elle est précisée, la tolérance doit inclure la valeur de distance et l'unité de distance. Les valeurs de distance renvoyées dans la réponse sont exprimées dans les unités précisées dans la requête (par défaut, il s'agit de mètres). |
| 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). |
| geometryAttributeName= geomname |
Chaîne | non | Attribut de définition géométrique de la table à utiliser pour le traitement de la requête spatiale. Cet attribut n'est nécessaire que pour les tables contenant plus d'une définition d'attribut géométrique. |
| page=pagenumber | Chaîne | non | Numéro de page à renvoyer. |
| pageLength= pagelength |
Chaîne | non | Nombre de fonctions renvoyées sur chaque page. Si le paramètre page est précisé dans la requête, vous devez définir pageLength. |
Résultat
Renvoie les métadonnées d'une table nommée du référentiel.
Exemples
Renvoie les capitales du monde qui se trouvent à une distance de 1 000 miles du point défini. Tous les attributs des fonctions trouvées dans WorldcapTable sont renvoyés.
http://www.pbbi.com/rest/Spatial/FeatureService/tables/Samples/NamedTables/WorldcapTable/
features.json?q=searchAtPoint&point=-75.651157,45.374245,EPSG%3A4326&tolerance=1000%20mi
Renvoie les capitales du monde qui se trouvent à une distance de 500 miles du point défini. Seuls les attributs Country et Cap_Pop des fonctions trouvées dans WorldcapTable sont renvoyés.
http://www.pbbi.com/rest/Spatial/FeatureService/tables/Samples/NamedTables/WorldcapTable/
features.json;attributes=Country,Cap_Pop?q=searchAtPoint&point=-75.651157,45.374245,
EPSG%3A4326&tolerance=500%20mi&destinationSrs=epsg:3857
Renvoie les capitales du monde qui se trouvent à une distance de 500 miles du point défini. Seul l'attribut Country des fonctions trouvées dans WorldcapTable est renvoyé, dans l'ordre de tri descendant.
http://www.pbbi.com/rest/Spatial/FeatureService/tables/Samples/NamedTables/WorldcapTable/features.json;
attributes=Country;orderBy=Country%20D?q=searchAtPoint&point=-75.651157,45.374245,
EPSG%3A4326&tolerance=500%20mi