OSMOverpassConnector
Nécessite la version 2021.1 de FME ou plus récente.
Ce Transformer extrait des informations portant sur de nombreuses thématiques (commerces, limites administratives, routes...) partout dans le monde de l’API Overpass d’OpenStreetMap (OSM).
La recherche s’effectue à partir d’une zone géographique donnée (rectangle englobant d’un polygone), d’une clé correspondant à une thématique et d’une valeur correspondant à l’objet recherché. Il est nécessaire de fournir en entrée une géométrie de type area avec un système de projection valide. Les données en sortie auront le même système de projection que la géométrie en entrée. L’absence de système de projection entraîne l’échec du traitement.
Important
Le polygone en entrée doit être de type Area et avec un système de projection valide !
Il faut également faire attention au périmètre de la géométrie par rapport au type de données demandées. Un trop grand nombre de données peuvent surcharger la mémoire et compromettre la requête.
Aperçu du Transformer OSMOverpassConnector
Il y a trois types d’objets retournés :
Nœud (point) : élément de base de la structure OSM. Il est défini par une latitude et une longitude (éventuellement d’une altitude).
Chemin ou ligne (way) : suite de nœuds connectés.
Relation (relation) : ensemble d’objets (nœuds, chemins, relations) regroupés pour former un nouvel objet.
Les résultats en sortie
Aperçu des fleuves et rivières
Aperçu des frontières administratives
Important
Les relations complexes (avec plusieurs hiérarchies de relations) sont aplaties au même niveau et distribuées à la sortie correspondante en fonction de la géométrie. Il faut se référer à l'id d'OSM pour déterminer la relation parente.
Paramètres
Paramètres du Transformer OSMOverpassConnector
- Clef OSM
- Type
choix éditable
- Obligatoire
oui
- Défaut
vide
- Description
thématique de la recherche (shop, highway, public_transport, boundary…).
- Valeur OSM
- Type
chaîne de caractères
- Obligatoire
oui
- Défaut
vide
- Description
objet de la recherche (bakery, pastry, secondary, stop_area, administrative…).
Attributs en sortie
Le Transformer dispose de cinq sorties : Point, Line, Area, Initiator et Rejected.
Point
Sortie de la géométrie de type point.
Sortie Point du Transformer OSMOverpassConnector
Liste des attributs :
Nom attribut Transformer |
Description de l'attribut |
|---|---|
request.id |
Identifiant de l’objet OSM |
request.key |
Thématique de la recherche |
request.value |
Objet de la recherche |
JSONTags |
Liste des tags (informations sur l’objet OSM) sous forme de JSON |
Les tags sont également disponibles sous forme de liste FME non exposé.
Line
Sortie de la géométrie de type ligne. Les attributs en sortie sont identiques à ceux de point.
Liste des attributs :
Nom attribut Transformer |
Description de l'attribut |
|---|---|
request.id |
Identifiant de l’objet OSM |
request.key |
Thématique de la recherche |
request.value |
Objet de la recherche |
JSONTags |
Liste des tags (informations sur l’objet OSM) sous forme de JSON |
Les tags sont également disponibles sous forme de liste FME non exposé.
Area
Sortie de la géométrie de type area. Les attributs en sortie sont identiques à ceux de point.
Liste des attributs :
Nom attribut Transformer |
Description de l'attribut |
|---|---|
request.id |
Identifiant de l’objet OSM |
request.key |
Thématique de la recherche |
request.value |
Objet de la recherche |
JSONTags |
Liste des tags (informations sur l’objet OSM) sous forme de JSON |
Les tags sont également disponibles sous forme de liste FME non exposé.
Initiator
La sortie Initiator résume chaque requête avec le nombre de résultats trouvés pour chacune d'entre elles et les données en entrée.
Sortie Initiator du Transformer OSMOverpassConnector
Liste des attributs :
Nom attribut Transformer |
Description de l'attribut |
|---|---|
request.key |
Thématique de la recherche |
request.value |
Objet de la recherche |
request.nbResult |
Nombre de résultat total par entrée |
Exemple
Dans cet exemple, l'utilisateur cherche à obtenir les limites administratives de Marseille.
Le polygone de la ville de Marseille est donné en entrée.
Pour trouver les limites administratives, l'utilisateur demande boundary en clef et administrative en valeur (ces informations sont disponibles sur la documentation OSM).
L'API renvoie alors des informations et des coordonnées permettant de reconstruire la géométrie.
Ici il a la sortie Point qui représente, pour ce cas, en majorité les centres administratifs, la sortie Line qui est constituée des frontières et la sortie Area qui permet de visualiser les zones administratives.
Dans cet exemple, l'utilisateur a sélectionné le quartier administratif Le Capitol dont l'identifiant OSM est le 6581590. L'attribut JSONTags donne plus d'informations sur l'objet sélectionné. Les tags sont également disponibles sous forme d'attributs FME non exposés.
Sortie Area du Transformer OSMOverpassConnector avec la géométrie correspondante