FindNearest Point of Interest
La fonction Find Nearest Points of Interest trouvent les points d'intérêt (POI) les plus proches d'une position donnée. La méthode FindNearestPOIs se trouve dans la classe AutoSuggestAPI :
com.mapinfo.mapmarker.autosuggest.api.AutoSuggestAPI.findNearestPOIs
Remarque : Les fonctions POI (y compris FindNearest Point of Interest) sont disponibles uniquement si vous avez une licence et installé les données de POI. FindNearestPOI ne renvoie aucun candidat, sauf si vous avez une licence et installé les données de POI.
La méthode FindNearestPOIs accepte les paramètres et les contraintes suivants.
| Paramètre ou contrainte | Valeurs | Obligatoire ou facultatif et utilisation |
|---|---|---|
| Country | CTY : Code pays ISO de 3 caractères. | Facultatif. Si aucune valeur n'est précisée, la recherche porte sur tous les pays disponibles |
| Origine | Latitude/longitude de l'origine. Ces valeurs définissent le centre de la zone de recherche. | Obligatoire. |
| Nombre maximal de candidats | MaxCandidates : Nombre maximal de candidats de POI renvoyés. La valeur maximale est 100. La valeur par défaut est 5. | Facultatif. Si le nombre maximal de candidats n'est pas précisé, tous les POI figurant dans la distance de recherche sont renvoyés. Si cette valeur n'est pas précisée, par défaut, 5 candidats sont renvoyés. |
| Rechercher une distance | SearchDistance : Distance maximale depuis l'origine à rechercher. | Facultatif. Si la distance de recherche n'est pas spécifiée, sa valeur est 5. |
| Unités de la distance de recherche | Units : Unité de mesure de la distance de recherche. Il peut s'agir de kilomètres, de miles, de mètres ou de pieds. La valeur par défaut est le kilomètre. | Facultatif. Si cette valeur n'est pas précisée, l'unité de distance par défaut est le kilomètre. |
| Paramètres régionaux | Les paramètres régionaux sont activés uniquement pour FindNearest POI. L'anglais est toujours disponible, et il s'agit de la langue par défaut. Vous pouvez également sélectionner Natif si les catégories et les sous-catégories de POI ont été localisées. Natif fait référence à la langue locale pour ce pays. | Facultatif. Si les paramètres régionaux sont définis et disponibles, les POI sont renvoyés dans cette langue. Si les paramètres régionaux sont définis, mais pas disponibles, les POI sont renvoyés en anglais. Si les paramètres régionaux ne sont pas spécifiés, les POI sont renvoyés dans la langue native (autre que l'anglais), si elle est disponible ; sinon, les POI sont renvoyés en anglais. |
Pour utiliser cette fonction depuis Management Console, procédez comme suit :
- Dans l'onglet GeocComplete sous , sélectionnez FindNearest POI. Cette opération active la sélection des paramètres régionaux.
- Dans la zone Paramètres régionaux, sélectionnez les paramètres régionaux de votre choix. L'anglais est la langue par défaut, mais vous pouvez sélectionner Natif pour les catégories/sous-catégories localisées. Le contenu localisé est disponible uniquement pour certains pays.
- Sélectionnez le nombre de candidats maximal (par défaut, 5) et l'unité de distance (par défaut, les kilomètres).
- Dans l'onglet , sélectionnez Rayon de recherche (la valeur par défaut est 0). Zéro signifie qu'il n'existe aucune restriction de distance de recherche.
- Pour rechercher le point d’intérêt le plus proche, indiquez un nom ou une marque et l’origine de la zone de recherche (longitude/latitude) dans l'onglet Aperçu et cliquez sur Exécutez Prévisualisation.