Geocoder

Utilise divers services web externes pour convertir les adresses en coordonnées de latitude/longitude, ou pour trouver les adresses les plus proches des coordonnées de latitude/longitude (géocodage inverse). Certains services proposent des informations supplémentaires, comme le fuseau horaire ou l'altitude.

Aller à la configuration

Cas d'utilisation courants

Recherche de coordonnées et création de géométries dans un réseau de rues
Recherche d'adresses qui correspondent à des coordonnées

Comment fonctionne-t-il ?

Le Geocoder fournit une interface unique à de nombreux services web de géocodage. Une fois qu'un service est sélectionné, les paramètres appropriés sont présentés, y compris les informations d'identification de connexion et les attributs attendus dont le service a besoin pour effectuer le géocodage.

Les attributs des entités transitant dans le Transformer sont récupérés par le service.

Si l'entité est correctement traitée par le service, les résultats (attributs et/ou géométries) sont ajoutés à l'entité qui ressort par ce port.

Si le géocodage de l'entité échoue pour n'importe quelle raison que ce soit, (dont les adresses non trouvées, les coordonnées invalides, ou des erreurs d'authentification), l'entité ressort par ce port.

Modes

Le géocodeur peut effectuer une variété de tâches, selon le service que vous choisissez d'utiliser. Chaque service fournira un ou plusieurs de ces modes de géocodage :

Géocodage d'adresses de rues en avant	Une unique adresse vers des valeurs latitude/longitude, par exemple : "7445, 132nd Street, Surrey, BC, V3W 1J8" Des éléments d'adresse de rue vers des valeurs latitude/longitude, par exemple : "7445" "132nd" "Street" "Surrey" "BC" "V3W 1J8"
Forward IP Address Geocoding	Chaîne d'adresse IP en valeurs latitude/longitude
Transférer le géocodage de l'adresse à l'identifiant du service	Une seule adresse de rue de forme libre ou des éléments d'adresse de rue distincts vers un identifiant spécifique au service
Géocodage inverse d'adresse de rues	Valeurs longitude/latitude vers des adresses de rue uniques.
Géocodage Altitude inverse	Les valeurs latitudes/longitudes vers des valeurs d'altitudes en mètres.
Géocodage Fuseau horaire inverse	Latitude/longitude vers les codes, noms et décalages de fuseaux horaires.
Géocodage inversé de l'adresse de la rue à partir de l'identifiant du service	Clé de recherche spécifique à un service pour une seule chaîne d'adresses de rue

Le résultat du service de géocodage est stocké dans les attributs de l'entité de sortie, la géométrie de l'entité, ou les deux. Par exemple, la sortie de latitude/longitude est représentée sur l'entité comme une géométrie de point, et aussi comme des attributs '_latitude' et '_longitude'.

Notes

De nombreux services ont des restrictions sur l'utilisation ou l'affichage de leurs résultats. Vérifiez les termes et conditions auprès du service que vous avez choisi. Voir les services disponibles.
Le format d'adresse d'entrée attendu varie selon les services. Consultez la documentation fournie par le service que vous avez choisi pour plus de détails.
Si vous avez besoin de créer des adresses pour votre service, vous pouvez les construire dans le Geocoder en utilisant l'éditeur de texte, ou via AttributeManager pour les construire comme des attributs permanents.

Configuration

Ports d'entrée

Ports de sortie

Output

Lorsque le processus de géocodage fonctionne avec succès, le Transformer génère l'entité avec de nouveaux attributs et la géométrie remplacée. Les attributs possiblement ajoutés sont :

_address	Une unique adresse de ligne
_address_json	Adresse multi éléments au format JSON
_latitude, _longitude	Latitude, Longitude
_elevation_meters, _elevation_feet, _elevation_resolution	Altitude en mètres et pieds avec une marge d'erreur.
_key	Un identifiant de service pour l'adresse géocodée
_precision_code, _precision_level	Precision information about a geocoded result.
_timezone	Nom court du fuseau horaire. Exemple : America/Vancouver
_timezone_name	Description du fuseau Exemple : Pacific Daylight Time
_timezone_offset	Décalage par rapport à UTC en secondes. Peut être négatif ou positif.
_timezone_current_dst	Décalage actuel en secondes par rapport à l'heure standard pendant l'heure d'été. Généralement 0 ou 3600, mais d'autres valeurs sont possibles.

Notez que les attributs peuvent ressortir sous une forme corrigée par rapport à leur format en entrée.

Par exemple, en fournissant "7445 132 street, surrey, bc" pour un géocodage direct, la valeur de l'attribut "_address" en sortie pourrait être "7445 132 St, Surrey, BC V3W, Canada". Ce résultat peut être utile pour la normalisation des données d'adresse.

Paramètres

Il s'agit d'une liste complète des paramètres possibles pour tous les services accessibles par le Geocoder. Seuls les paramètres requis spécifiques au service seront affichés dans le Transformer une fois qu'un service aura été choisi.

Connexion

Certains fournisseurs demandent à l'utilisateur de spécifier des informations d'identification supplémentaires, par exemple une clé API ou un nom d'utilisateur et un mot de passe, avant d'effectuer le géocodage. Des URL personnalisées sont également requises ou autorisées pour certains services.

URL	Le champ URL renvoie à un autre emplacement de serveur. Il s'agit généralement d'une version auto-hébergée du produit en ligne, qui utilise souvent les propres données du client au lieu du jeu de données générique mondial disponible au public.
Type d'authentification	Si un service prend en charge plus d'une façon de se connecter, le choix sera disponible ici.
Clé API	Certains services nécessitent une clé API, obtenue souvent en s'enregistrant sur un service en ligne. Les services qui nécessitent un clé ne peuvent pas être utilisés sans, car ce sont bien souvent des services payants ou limités. Les services pour lesquels une clé est optionnelle comportent généralement des limites en terme de performances.
Nom d'utilisateur/mot de passe Client/Secret ID/Code d'app	Certains services exigent ou permettent une authentification avec un nom d'utilisateur et un mot de passe, un ID d'app et un Code d'app, ou une clé et un secret du client.

Paramètres de géocodage

Voici la liste complète des paramètres possibles pour tous les services. Notez que chaque service ne supportera pas tous les paramètres listés ci-dessous.

Mode	Si le service choisi prend en charge plusieurs modes de géocodage, ils pourront être sélectionnés ici. Par exemple, le service Google prend en charge les modes "Forward", "Reverse", "Elevation" et "Timezone". Si ce n'est pas le cas, le géocodage avant est toujours supposé. Ce choix détermine également le mode de saisie qui devient actif. Le géocodage avant accepte en entrée les rues et des adresses IP, alors que le géocodage d'altitude, inverse ou de fuseau horaire attendent des latitudes et longitutde en entrée.
Adresse	Pour une adresse sur une seule ligne, une liste d'éléments d'adresse séparés par des virgules. Par exemple, 123 Main Street, Surrey, BC, Canada. Cette chaîne peut être facilement construite à partir d'attributs séparés, si nécessaire, en utilisant l'éditeur de texte pour les combiner directement dans le Transformer, ou en utilisant un AttributeManager qui précède dans l'espace de travail.traitement Notez que certain services sont moins tolérants que d'autres. Pour les éléments d'adresse discrets, l'adresse de la rue ne contient généralement que le numéro de la maison et le nom de la rue. Par exemple, 123 Main Street. Ce champ est utilisé conjointement avec d'autres champs pour spécifier une adresse complète.
Ville	Nom de la commune.
Province/Etat	Nom complet ou abbréviation de la province ou de l'Etat.
Code Postal/ZIP	Code postal ou code ZIP de la commune.
Pays	Le nom du pays, à utiliser dans la spécification d'adresse discrète.
Latitude/Longitude	Valeurs distinctes pour une paire latitude et longitude. Exemple : Latitude: 49.1044 Longitude: -122.8011
Rayon	Recherche dans un rayon autour des coordonnées fournies.
Out Fields	Sélectionnez des attributs supplémentaires à inclure dans l'entité de sortie. Les valeurs de ces attributs seront prises directement dans la réponse du serveur de géocodage.
Addresse IP	An IPv4 or IPv6 address. Exemple : 199.7.157.0, or 2001:0db8:0a0b:12f0:0000:0000:0000:0001
Langage de retour	Pour certains services, il est possible de spécifier une langue pour les résultats du géocodage. Cela s'applique généralement aux adresses corrigées pour le géocodage direct ainsi qu'aux adresses de résultat du géocodage inverse. Exemple : Gécodage inversé de 52.07, 4.28 qui retourne “The Hague” en anglais (en), mais “Den Haag” en allemand (nl).

Avancé

Délai d'attente	L'utilisateur peut éventuellement fournir une valeur dans ce champ pour définir la durée maximale, en secondes, de l'attente d'une seule demande. Après le temps spécifié, si une demande n'a pas abouti, elle sera réessayée, jusqu'à un maximum de 3 tentatives. Si elle n'aboutit pas, l'entité sera éditée avec un code d'erreur.
Requêtes concurrentes Maximum	Ceci spécifie le nombre de requêtes de géocodage à effectuer en parallèle. Veuillez noter que cela peut entraîner une limitation du débit du service de géocodage. Le géocodeur attendra automatiquement et réessaiera la demande jusqu'à un maximum de 3 tentatives après un échec dû à la limitation du débit.
Inclure la réponse JSON complète	Si Oui, un attribut nommé json_response sera inclus dans l'entité de sortie, contenant la réponse JSON brute du service de géocodage.
Vérifier les certificats HTTPS	Ce paramètre détermine si les certificats HTTPS doivent être vérifiés lors des requêtes Web. La valeur de ce paramètre remplacera le paramètre Vérifier les certificats SSL qui peut être défini par une connexion web utilisée lors de l'utilisation du service de géocodage d'ArcGIS Server.

Services de géocodage

Services de géocodage et types disponibles

Les services suivants sont supportés :

Service	Modes
ArcGIS Online	En avant, inversé
Serveur ArcGIS	En avant, inversé
Bing	En avant, inversé
Geocode.Farm	En avant, inversé
Geocoder.ca	En avant, inversé
Google	En avant, En arrière, Elévation, Fuseau horaire
HERE	En avant, inversé
IPInfo.io	Addresse IP
ipstack	Addresse IP
OpenCage	En avant, inversé
OpenStreetMap	En avant, inversé
Precisely	Avant, Arrière, avant vers la clé, arrière à partir de la clé
TAMU	En avant, avec les informations de la région recensée

Notez que de nombreux services ont des exigences supplémentaires pour leur utilisation. Une exigence courante est que les données résultantes soient affichées sur une carte du même service. Le stockage des données de résultat dans une base de données peut également nécessiter des frais supplémentaires. Veuillez consulter les conditions de service des fournisseurs de géocodage (énumérés ci-dessous) pour vous assurer que votre utilisation est conforme.

Informations relatives aux services de géocodage.

ArcGIS Online	Pour accéder à ce service de géocodage, vous devez fournir des identifiants d'accès ArcGIS Online valides. Contactez Esri pour configurer votre propre compte ArcGIS Online : http://www.arcgis.com/features/plans/pricing.html. Notez que l'utilisation de ce Transformer Geocoder peut épuiser les crédits et que vous pouvez être soumis à des limites de transaction. Pour plus d'informations, veuillez consulter le site https://developers.arcgis.com/rest/geocode/api-reference/overview-world-geocoding-service.htm. Voir les conditions d'utilisation avant utilisation https://developers.arcgis.com/terms.
Serveur ArcGIS	Ce type de service utiliser un géocodeur publié sur une installation locale ArcGis. Il est recommandé d'utiliser une connexion web Esri ArcGIS Portal pour accéder à un serveur authentifié. Il vous sera demandé de fournir l'URL du serveur de géocodage spécifique hébergé sur le portail. Pour plus d'information, voir https://enterprise.arcgis.com/en/server/latest/publish-services/windows/geocode-services.htm.
Bing	Pour accéder à ce service de géocodage, vous devez fournir des informations d'accès valides à Bing Maps. Contactez Microsoft pour configurer votre propre compte Bing Maps : https://www.microsoft.com/maps/Licensing/licensing.aspx. Notez que l'utilisation de ce Transformer Geocoder peut épuiser les crédits et que vous pouvez être soumis à des limites de transaction. Veuillez consulter les conditions d'utilisation avant de l'utiliser : https://www.microsoft.com/maps/product/terms.html.
Geocode.Farm	Pour accéder à ce service de géocodage, vous devez fournir des informations d'accès valides à Geocode.Farm. Contactez Geocode.Farm pour créer votre propre compte : https://geocode.farm/register. Notez que l'utilisation de ce Géocodeur peut nécessiter des crédits et vous pouvez de la sorte être limité. Consulter les conditions d'utilisation de ce service https://geocode.farm/policies/terms-of-service.
Geocoder.ca	Pour accéder à ce service de géocodage, vous devez fournir des données d'accès valides à Geocoder.ca. Contactez Geocoder.ca pour créer votre propre compte : http://geocoder.ca/?register=1. Notez que l'utilisation de ce Géocodeur peut nécessiter des crédits et vous pouvez de la sorte être limité. Veuillez consulter les conditions d'utilisation de ce service sur : http://geocoder.ca/?terms=1.
Google	Pour accéder à ce service de géocodage, vous devez fournir une clé API Google Maps Geocoding valide. Contactez Google pour créer votre propre compte : https://developers.google.com/maps/documentation/geocoding/get-api-key. Notez que l'utilisation du Transformer Geocoder avec ce service peut épuiser les crédits et que vous pouvez être soumis à des limites de transaction. Pour plus d'informations, veuillez consulter le site https://developers.google.com/maps/documentation/geocoding/usage-limits. Voir les conditions d'utilisation avant utilisation https://developers.google.com/maps/terms. Important : l'API Google Maps Geocoding ne peut être utilisée qu'en conjonction avec l'affichage des résultats sur une carte Google. Il est interdit d'utiliser les données de l'API Google Maps Geocoding sans afficher une carte Google. Pour plus d'informations, veuillez consulter : https://developers.google.com/maps/documentation/geocoding/policies.
HERE	Pour accéder à ce service de géocodage, vous devez fournir des identifiants d'accès HERE valides. Contactez HERE pour créer votre propre compte : https://developer.here.com/plans/api/geocoder. Notez que l'utilisation de ce Transformer Geocoder peut épuiser les crédits et que vous pouvez être soumis à des limites de transaction. Vous n'êtes pas autorisé à afficher ou à visualiser les résultats sur un contenu tiers (tel qu'une carte, des vues de rues ou des images satellites) n'appartenant pas à HERE. Consutler les conditions d'utilisation de ce service sur la page https://developer.here.com/terms-and-conditions.
IPInfo.io	Ce service de géocodage a des volumes de transactions limités en fonction de votre niveau d'abonnement. Contactez IPInfo.io pour créer votre propre compte : https://ipinfo.io/pricing. Consulter les conditions d'utilisation de ce service : https://ipinfo.io/developers.
ipstack	Pour accéder à ce service de géocodage, vous devez fournir une clé API ipstack valide. Pour obtenir une clé API, créez un compte sur https://ipstack.com/. ipstack est le successeur de FreeGeoIP.net, qui a fermé ses portes le 2018-07-01. FreeGeoIP.net a été supprimé du géocodeur dans FME 2018.1. Notez que l'utilisation de ce Transformer Geocoder avec ce service peut épuiser les crédits et vous pouvez être soumis à des limites de transaction. Veuillez consulter les conditions d'utilisation du service avant de l'utiliser : https://ipstack.com/terms.
OpenCage	Pour accéder à ce service de géocodage, vous devez fournir des informations d'accès valides à OpenCage Geocoder. Contactez OpenCage Data pour créer votre propre compte : https://geocoder.opencagedata.com/pricing. Notez que l'utilisation de ce Transformer Geocoder peut épuiser les crédits et que vous pouvez être soumis à des limites de transaction. Veuillez consulter les conditions d'utilisation avant de l'utiliser : https://geocoder.opencagedata.com/terms.
OpenStreetMap (Nominatim)	Ce service est destiné à être utilisé avec un serveur Nominatim auto-hébergé. De plus amples informations sur l'installation d'un serveur Nominatim sont disponibles à l'adresse suivante : http://wiki.openstreetmap.org/wiki/Nominatim/Installation. Pour utiliser votre propre serveur avec le Geocoder, fournissez l'URL complète. Celle-ci se termine généralement par "search" - par exemple, http://nominatim.example.com/search. Le serveur Nominatim d'OpenStreetMaps, bien que disponible publiquement, n'est pas destiné à une utilisation intensive et comporte plusieurs restrictions d'utilisation qui le rendent inapproprié pour une utilisation avec FME dans presque tous les cas : https://operations.osmfoundation.org/policies/nominatim/ .
Precisely	Pour accéder à ce service de géocodage, vous devez fournir des informations d'identification valides. Contactez Precisely pour créer votre compte : https://developer.precisely.com/ Notez que l'utilisation de ce Transformers Geocoder peut consommer des crédits et que vous pouvez être soumis à des limites de transaction. Veuillez consulter les conditions d'utilisation avant de l'utiliser. https://developer.precisely.com/pricing .
TAMU (Texas A&M University Geoservices)	Pour accéder à ce service de géocodage, vous devez fournir des identifiants d'accès valides. Contactez Texas A&M Geoservices pour créer votre propre compte : http://geoservices.tamu.edu/Pricing. Notez que l'utilisation du Transformer Geocoder avec ce service peut épuiser les crédits et vous pouvez être soumis à des limites de transaction. Veuillez consulter les conditions d'utilisation du service avant de l'utiliser : http://geoservices.tamu.edu/About/Legal.

Éditer les paramètres des Transformers

À l'aide d'un ensemble d'options de menu, les paramètres du Transformer peuvent être attribués en faisant référence à d'autres éléments de traitement. Des fonctions plus avancées, telles qu'un éditeur avancé et un éditeur arithmétique, sont également disponibles dans certains Transformers. Pour accéder à un menu de ces options, cliquez sur à côté du paramètre applicable. Pour plus d'informations, voir Options de menus et paramètres de Transformer.

Définir les valeurs

Il existe plusieurs façons de définir une valeur à utiliser dans un Transformer. La plus simple est de simplement taper une valeur ou une chaîne de caractères, qui peut inclure des fonctions de différents types comme des références d'attributs, des fonctions mathématiques et de chaînes de caractères, et des paramètres de traitement. Il existe un certain nombre d'outils et de raccourcis qui peuvent aider à construire des valeurs, généralement disponibles dans le menu contextuel déroulant adjacent au champ de valeur.

Définir des valeurs de paramètres

Utilisation de l'éditeur de texte

L'éditeur de texte fournit un moyen efficace de construire des chaînes de textes (dont les expressions régulières) à partir de données source diverses, telles que des attributs, des paramètres et des constantes, et le résultat est directement utilisé dans le paramètre.

Editeur de texte

Utilisation de l'éditeur arithmétique

L'éditeur arithmétique fournit un moyen simple de construire des expressions mathématiques à partir de plusieurs données source, telles que des attributs et des fonctions, et le résultat est directement utilisé dans un paramètre.

Éditeur arithmétique

Valeur conditionnelle

Définit des valeurs selon un ou plusieurs tests.

Fenêtre de définition de conditions

Contenu

Les expressions et chaînes de caractères peuvent inclure des fonctions, caractères, paramètres et plus.

Lors du paramétrage des valeurs - qu'elles soient entrées directement dans un paramètre ou construites en utilisant l'un des éditeurs - les chaînes de caractères et les expressions contenant des fonctions Chaîne de caractères, Math, Date et heure ou Entité FME auront ces fonctions évaluées. Par conséquent, les noms de ces fonctions (sous la forme @<nom_de_fonction>) ne doivent pas être utilisés comme valeurs littérales de chaîne de caractères.

Types de contenu

Fonctions chaînes de caractères	Ces fonctions manipulent les chaînes de caractères.
Caractères spéciaux	Un ensemble de caractères de contrôle est disponible dans l'éditeur de texte.
Fonctions mathématiques	Plusieurs fonctions sont disponibles dans les deux éditeurs.
Fonctions Date/heure	Les fonctions de dates et heures sont disponibles dans l'Editeur texte.
Opérateurs mathématiques	Ces opérateur sont disponibles dans l'éditeur arithmétique.
Fonctions d'entités	Elles retournent des valeurs spécifiques aux entités.
Paramètres FME	Les paramètres FME et spécifiques au traitement peuvent être utilisés.
Créer et modifier un paramètre publié	Créer ses propres paramètres éditables.

Options - Tables

Les Transformers avec des paramètres de style table possèdent des outils additionnels pour remplir et manipuler des valeurs.

Outils de tableau

Réordonner

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

Ajouter une ligne
Supprimer une ligne
Déplacer la ligne en cours au dessus
Déplacer la ligne en cours en dessous
Déplacer la ligne en cours en haut de liste
Déplacer la ligne en cours en bas de liste

Couper, Copier et Coller

Activé une fois que vous avez cliqué sur un élément de ligne. Les choix comprennent :

Couper une ligne - supprime et copie dans le presse-papiers.
Copie une ligne dans le presse-papiers.
Colle une ligne depuis le presse-papiers.

Copier, copier et coller peuvent être utilisés au sein d'un Transformer ou entre Transfromers.

Filtre

Commencez à taper une chaîne de caractères, et la matrice n'affichera que les lignes correspondant à ces caractères. Recherche dans toutes les colonnes. Cela n'affecte que l'affichage des attributs dans le Transformer - cela ne change pas les attributs qui sont sortis.

Importer

Le bouton d'import remplit la table avec un jeu de nouveaux attributs lus depuis un jeu de données. L'application spécifique varie selon les Transformers.

Réinitialiser/Rafraîchir

Réinitialise la table à son état initial, et peut fournir des options additionnelles pour supprimer des entrées invalides. Le comportement varie d'un Transformer à l'autre.

Note : Tous les outils ne sont pas disponibles dans tous les Transformers.

Références

Comportement	Basé sur des entités
Stockage des entités	Non
Dépendances	Services de géocodage externes
Alias
Historique	Ce Transformers de FME Package remplace le Geocoder livré à l'origine avec FME 2021.1 et les versions antérieures.

FME Community

FME Community est l'endroit où trouver des démos, des tutoriaux, des articles, des FAQ et bien plus encore. Obtenez des réponses à vos questions, apprenez des autres utilisateurs et suggérez, votez et commentez de nouvelles entités.

Voir tous les résultats à propos de ce Transformer sur FME Community.

Les exemples peuvent contenir des informations sous licence Open Government - Vancouver et/ou Open Government - Canada.