Paramètres

Vous permet de limiter le nombre d’enregistrements renvoyés et la distance de recherche, ainsi que d'inclure la distance jusqu'au bord, le nombre et les champs d’index pour la sortie.

Tableau 1. Paramètres de Find Nearest
Option de sortie Description
Limites Ces paramètres limitent le nombre maximal d’enregistrements qui peuvent être renvoyés pour n’importe quelle géométrie de recherche. Pour garantir les meilleures performances de vos flux et du système, il est vivement recommandé de définir au moins l'une de ces limites.
Limiter le nombre d'enregistrements renvoyés

Par défaut, cette option est sélectionnée avec une valeur 1. Si elle n’est pas sélectionnée, tous les candidats les plus proches qui se trouvent à la distance spécifiée sont renvoyés. Cela peut affecter les performances.

Une valeur spécifiée dans le champ d’entrée MaxCandidates remplace ce paramètre.

Limiter la distance de recherche

Par défaut, cette option est définie sur une valeur de 1 mile. Les valeurs valides sont > ou = 0, mais une distance de recherche égale à 0 renvoie seulement des résultats qui croisent la géométrie d’entrée. Les unités disponibles sont les miles, les centimètres, les pieds, les pouces, les kilomètres, les mètres ou les yards.

Les valeurs spécifiées dans les champs d’entrée MaxDistance et MaxDistanceUnit remplacent ce paramètre.

Distance

Inclure la distance

Cette option (qui est sélectionnée par défaut) s’avère utile lorsque vous souhaitez connaître la distance la plus courte d’une géométrie d’entrée à l’enregistrement renvoyé.

Champ Distance - contient la distance la plus courte d'une géométrie d'entrée à l'enregistrement renvoyé. Lorsque l’enregistrement renvoyé contienne ou croise l’entrée, la distance renvoyée est zéro.

Champ Unité de distance - nom du champ de sortie qui contient l’unité de distance.

Unité de distance - représente l’unité de mesure de la distance renvoyée (miles, centimètres, pieds, pouces, kilomètres, mètres ou yards).

Inclure la distance par rapport au bord

Cette option s’avère utile lorsque vous avez besoin de connaître la proximité d’un point par rapport au bord d’une géométrie. Par défaut, elle n'est pas sélectionnée.

Champ Distance jusqu'au bord - nom du champ de sortie qui contient la distance jusqu'au bord. Contient toujours la distance la plus courte jusqu’au bord ; autrement dit, la distance entre les deux points les plus proches de la géométrie d’entrée et la géométrie de l’enregistrement renvoyé. L’unité de la distance renvoyée est la même que celle sélectionnée dans la liste déroulante Unité de Distance ci-dessus.

Des géométries avec des bords qui se croisent renvoient zéro. Si une géométrie contient entièrement l’autre, le champ renvoie une valeur de distance.

Include count and index

Cette option s'avère utile lorsqu'un grand nombre d'enregistrements sont renvoyés et que vous devez distinguer différents enregistrements les uns des autres.

Champ Nombre - nom du champ de sortie qui contient le nombre total d'enregistrements renvoyés pour chaque entrée.

Champ Index - indique l’ordre de l’enregistrement en cours dans la collection d’enregistrements de sortie.

Par exemple, « 1 of 5 » a un nombre égal à 5 et un index égal à 1.