Opération

Renvoie des géométries de point des adresses dans une table, à savoir, un géocodage. Spécifiez une chaîne d'adresse dans la propriété Search Text ou des parties structurées dans les propriétés correspondantes telles que Country, Street, etc. Les combinaisons sont également autorisées. Cette opération requiert une licence spéciale. Les adresses introuvables, quelle qu'en soit la raison, ne sont as renvoyées dans le résultat.

La fonctionnalité offerte par Géocodage Qlik (via AddressPointLookup et PointToAddressLookup) est différente des autres fonctions de recherche d'emplacement. Géocodage Qlik permet les recherches au niveau de l'adresse, alors que les recherches d'emplacement standard offrent une précision limitée au niveau du code postal.

Lorsque vous commencez à travailler avec Géocodage Qlik, utilisez le modèle référencé sous Configuration de Géocodage Qlik (uniquement en anglais).

La plupart des paramètres se présentent en deux versions, l'une qui spécifie la valeur réelle, comme country="SWE", et l'autre qui spécifie un nom de champ à partir duquel récupérer la valeur réelle, comme countryField="CountryIso2".

Renvoie les colonnes suivantes :

• <dataset key column> - Colonne de clés de l'ensemble de données d'entrée.
• Address - Adresse trouvée, formatée en fonction des normes d'adresse du pays.
• Geometry - Point de l'élément trouvé.
• HouseNumber - Numéro de résidence de l'élément trouvé.
• Street - Rue de l'élément trouvé.
• PostalCode - Code postal de l'élément trouvé.
• City - Nom de la division administrative au niveau de la ville de l'élément trouvé.
• Adm1 - Nom ou nom abrégé de la division administrative de premier ordre (state) de l'élément trouvé.
• CountryIso2 - Code de pays de l'élément trouvé.
• Match - valeur comprise entre 0 et 1 indiquant la qualité de la correspondance. Une valeur égale à 1 signifie une correspondance parfaite.
• Toutes les colonnes sauf la colonne de clés de dataset, avec le préfixe du nom d'ensemble de données.

Les champs renvoyés peuvent être vides s'ils ne s'appliquent pas ou si les données ne sont pas disponibles.

Prend en charge :

• ScriptEval dans les scripts de chargement.

Exemple qui géocode certaines adresses suédoises dans lesquelles chaque élément se trouve dans son propre champ :

Cet exemple illustre un géocodage dans un style de texte libre :

Génère des compartiments rectangulaires ou hexagonaux pour un ensemble de données de points. Il s'agit d'une manière d'agréger des données de points afin de pouvoir afficher efficacement une vue d'ensemble des données.

Renvoie les colonnes suivantes :

• <dataset key column> - Colonne de clés de l'ensemble de données d'entrée.
• BinId - Identité du compartiment.
• BinTable.BinPolygon - Polygone du compartiment.
• BinTable.CenterPoint - Point au centre du compartiment.
• Toutes les colonnes sauf la colonne de clés de dataset, avec le préfixe du nom d'ensemble de données.

Prend en charge :

• ScriptEval dans les scripts de chargement.

Exemple qui charge des compartiments hexagonaux à partir des aéroports des États-Unis :

Renvoie les relations et les distances entre les objets d'un ensemble de données et les objets les plus proches d'un autre ensemble de données, si l'un d'entre eux est plus proche que la distance maximale. Le coût peut également être calculé le long des routes et, dans ce cas, il est possible d'utiliser le temps de déplacement. Cette opération s'avère utile dans de nombreux cas, non seulement pour obtenir les relations par rapports aux objets les plus proches, mais également pour obtenir les matrices de distance entre un ensemble de points.

Renvoie les colonnes suivantes :

• <dataset1 name>_<dataset2 name>_RelationId - Clé générée pour la relation entre les deux géométries.
• <dataset1 key column> - Colonne de clés du dataset1 d'entrée.
• <dataset2 key column> - Colonne de clés du dataset2 d'entrée.
• Distance - Distance dans l'unité spécifiée dans costUnit.
• Status - Le statut renvoyé est "ok" ou "failed:", suivi d'un message d'erreur.
• LowResLine - Version basse résolution de la ligne d'itinéraire, uniquement disponible pour les types de distance autres que bird.
• Toutes les colonnes sauf la colonne de clés de l'ensemble de données dataset1 d'entrée, avec le préfixe du nom d'ensemble de données.
• Toutes les colonnes sauf la colonne de clés de l'ensemble de données dataset2 d'entrée, avec le préfixe du nom d'ensemble de données.

Prend en charge :

• ScriptEval dans les scripts de chargement.

Cet exemple recherche les aéroports les plus proches des points d'une table :

Produit des clusters à partir d'un ensemble de données de points en fonction de la proximité géographique entre les points. La génération de clusters est contrôlée par le paramètre distance, qui définit l'éloignement maximal d'un point par rapport au cluster auquel il appartient. Renvoie une table avec des relations entre les points et les clusters. Renvoie également une table jointe nommée Clusters avec des géométries de cluster. Elle contient les champs ClusterID, ClusterCenter (géométrie de point) et PointCount. Le champ count contient le nombre de points du cluster.

Renvoie les colonnes suivantes :

• <dataset key column> - Colonne de clés de l'ensemble de données d'entrée.
• ClusterID - ID du cluster auquel le point appartient.
• Clusters.ClusterPoint - Point central du cluster.
• Clusters.PointCount - Nombre de points d'origine appartenant au cluster.
• Toutes les colonnes sauf la colonne de clés de l'ensemble de données d'entrée, avec le préfixe du nom d'ensemble de données.

Prend en charge :

• ScriptEval dans les scripts de chargement.

Cet exemple regroupe les aéroports aux États-Unis de sorte que les aéroports à une distance inférieure à 50 km appartiennent à un cluster :

Dissout et simplifie les zones pour former des zones plus grandes basées sur le mappage entre d'anciennes identités de zone (ou géométries) et de nouvelles identités de zone. Cela est généralement utilisé pour créer des zones personnalisées à partir de zones plus petites bien définies telles que des zones postales ou des régions administratives.

Renvoie les colonnes suivantes :

• <dissolveField> - Champ spécifié comme dissolveField dans indata.
• DissolvedPolygon - Géométries des nouvelles zones dissoutes.

Prend en charge :

• ScriptEval dans les scripts de chargement.

L'ensemble de données geometry est facultatif. S'il n'est pas fourni, les géométries sont supposées être disponibles dans l'ensemble de données de définition Dissolve.

Notez que les chevauchements de polygones sont supprimés de toutes les résolutions sauf Source.

Cet exemple crée deux régions, l'une constituée de CA et de AZ et l'autre de WA et de OR :

Renvoie une table qui effectue un mappage entre la clé de l'ensemble de données dataset1 et la clé de l'ensemble de données dataset2 pour tous les objets qui s'intersectent. Si les deux ensembles de données contiennent des polygones, la zone de chevauchement relative par rapport aux zones de l'ensemble de données respectif est renvoyée.

Il est possible de limiter le nombre de géométries qui s'intersectent dans le deuxième ensemble de données qui doit être mappé vers chaque géométrie du premier ensemble de données en spécifiant intersectsCount. Dans ce cas, les géométries qui s'intersectent le plus sont renvoyées dans l'ordre. Si intersectsCount n'est pas spécifié, l'opération est symétrique.

Renvoie les colonnes suivantes :

• <dataset1 name>_<dataset2 name>_RelationId - Clé générée pour la relation entre les deux géométries.
• <dataset1 key column> - Colonne de clés du dataset1 d'entrée.
• <dataset2 key column> - Colonne de clés du dataset2 d'entrée.
• <dataset1 name>.RelativeOverlap - Chevauchement comparé au polygone de dataset1. Renvoyé uniquement si les deux ensembles de données contiennent des polygones. Si ce champ est demandé, cela a un impact sur les performances.
• <dataset2 name>.RelativeOverlap - Chevauchement comparé au polygone de dataset2. Renvoyé uniquement si les deux ensembles de données contiennent des polygones. Si ce champ est demandé, cela a un impact sur les performances.
• Toutes les colonnes sauf la colonne de clés de l'ensemble de données dataset1 d'entrée, avec le préfixe du nom d'ensemble de données.
• Toutes les colonnes sauf la colonne de clés de l'ensemble de données dataset2 d'entrée, avec le préfixe du nom d'ensemble de données.

Prend en charge :

• ScriptEval dans les scripts de chargement.

Cet exemple calcule les états intersectés par certaines lignes :

Renvoie les informations d'emplacement et les géométries de points des adresses IP dans une table. Cela s'avère utile si vous analysez les données d'accès à des services Web. La table renvoyée contient les champs suivants :

• Key field - Identique au champ clé de la table de noms.
• <Address Table Ip Field> - Identique au champ IP objet de la recherche. Disponible uniquement si différent du champ clé.
• IpPoint - Point de l'élément trouvé.
• CountryIso2 - Code de pays de l'élément trouvé.
• Adm1Code - Code de la zone administrative de premier ordre de l'élément trouvé. Notez que ce code n'est pas toujours compatible avec le code renvoyé par le service de localisation.
• City - Ville de l'élément trouvé.
• Toutes les colonnes sauf la colonne de clés de l'ensemble de données d'entrée, avec le préfixe du nom d'ensemble de données.

Par nature, la géolocalisation IP est imprécise. Pour de nombreuses adresses IP, il est possible de localiser une ville, mais, pour d'autres, seul le pays peut être résolu.

La meilleure pratique consiste à envoyer uniquement Ip-column à l'opération IpLookup. Exemple qui recherche des adresses IP :

Il est courant que la même adresse IP soit répétée dans de nombreuses lignes. Dans ce cas, cela améliore les performances de commencer par filtrer uniquement les adresses IP uniques, comme dans cet exemple :

Ce produit inclut les données GeoLite2 créées par MaxMind, disponibles auprès de MaxMind.

Charge l'ensemble de données sans appliquer aucune opération. Cela permet de charger tous les formats pris en charge par GeoOperations. Notez que, si les géométries sont détaillées et lentes à s'afficher, l'opération Simplify peut s'avérer une bonne alternative à l'opération Load.

Renvoie les colonnes suivantes :

• Toutes les colonnes de l'ensemble de données dataset.

Prend en charge :

• ScriptEval dans les scripts de chargement.

Exemple qui charge des codes postaux de Suède :

Étant donné que WKT est pris en charge comme format de géométrie pour les données dans INTABLE, l'opération Load s'avère excellente pour convertir des géométries géographiques chargées depuis une base de données en format de géométrie Sense afin de pouvoir être affichées. L'exemple suivant montre comment convertir des données WKT, dans ce cas, provenant de la table MyWKTData :

Renvoie l'adresse la plus proche des points de la liste, également appelé géocodage inversé. Cette opération requiert une licence spéciale. Les points qui sont proches des rues recevront des adresses au niveau de la rue, sinon, des résultats au niveau de la zone postale ou de la ville seront renvoyés. Pour les points trop éloignés, aucune donnée n'est renvoyée.

Renvoie les colonnes suivantes :

• <dataset key column> - Colonne de clés de l'ensemble de données d'entrée.
• Address - Adresse trouvée, formatée en fonction des normes d'adresse du pays.
• Geometry - Point de l'élément trouvé.
• HouseNumber - Numéro de résidence de l'élément trouvé.
• Street - Rue de l'élément trouvé.
• PostalCode - Code postal de l'élément trouvé.
• City - Nom de la division administrative au niveau de la ville de l'élément trouvé.
• Adm1 - Nom ou nom abrégé de la division administrative de premier ordre (state) de l'élément trouvé.
• CountryIso2 - Code de pays de l'élément trouvé.
• Distance - Distance en mètres de l'adresse trouvée.
• Toutes les colonnes sauf la colonne de clés de dataset, avec le préfixe du nom d'ensemble de données.

Notez que les champs renvoyés peuvent être vides s'ils ne s'appliquent pas ou si les données ne sont pas disponibles.

Exemple qui obtient les adresses de certains points :

Calcule les itinéraires, y compris la longueur et la durée, entre deux emplacements d'une table.

Notez que l'origine est la colonne de géométrie de l'ensemble de données. La colonne de destination est spécifiée dans les paramètres de l'opération, car les ensembles de données connaissent une seule colonne de géométrie.

Si vous utilisez bird comme type de transport, de grands cercles sont générés entre les origines et les destinations.

Renvoie les colonnes suivantes :

• <dataset key column> - Colonne de clés de l'ensemble de données d'entrée.
• Distance - Distance de l'itinéraire en mètres.
• Duration - Durée estimée de l'itinéraire en secondes.
• Status - Le statut renvoyé est "ok" ou "failed:", suivi d'un message d'erreur.
• LowResLine - Version basse résolution de la ligne d'itinéraire.
• Toutes les colonnes sauf la colonne de clés de l'ensemble de données d'entrée, avec le préfixe du nom d'ensemble de données.

Prend en charge :

• ScriptEval dans les scripts de chargement.
• ScriptEvalStr dans les scripts graphiques pour obtenir l'itinéraire.
• ScriptEval dans les scripts graphiques pour obtenir la distance ou la durée.

Voici un exemple qui calcule les itinéraires entre deux points d'un ensemble de données :

Voici un exemple qui calcule les itinéraires directement dans une couche de lignes. L'opération est appelée pour la sélection à chaque changement de sélection. Normalement, une condition de calcul doit être définie sur true uniquement si quelques points sont sélectionnés (sinon, il est préférable de calculer les itinéraires dans le script de chargement). Cela doit être placé dans le script de chargement pour charger les données. Par exemple :

Utilisez la dimension suivante dans la couche de lignes :

Utilisez une condition de calcul dans la couche de lignes :

Dans la propriété Location, qui doit être définie sur Line geometry, placez ce qui suit pour calculer les itinéraires d'un point fixe aux points sélectionnés :

Simplifie les géométries de ligne et de zone d'un ensemble de données. Il s'avère souvent utile de charger les données géographiques à l'aide de l'opération Simplify au lieu de l'opération Load pour obtenir des géométries plus efficaces qui sont plus rapides à afficher.

Le degré de simplification est automatiquement calculé en fonction de la zone, du nombre d'objets et de la taille des objets. Il est ensuite possible d'ajuster cela à une résolution supérieure ou inférieure à l'aide du paramètre resolution.

La zone de simplification est effectuée à l'aide d'un algorithme qui traite les topologies et qui peut supprimer les vides et les îlots de jointure.

La simplification des lignes est effectuée à l'aide d'un algorithme de réduction des points d'arrêt.

Notez que les chevauchements de polygones sont supprimés. La sortie ne contiendra aucun chevauchement de polygones.

Renvoie les colonnes suivantes :

• <dataset key column> - Colonne de clés de l'ensemble de données dataset1 d'entrée.
• Simplified_<geometry column name> - Versions simplifiées des géométries d'origine.
• Toutes les colonnes sauf la colonne de clés de dataset, avec le préfixe du nom d'ensemble de données.

Prend en charge :

• ScriptEval dans les scripts de chargement.

Exemple qui charge des versions simplifiées des états des États-Unis :

Calcule les zones de temps de déplacement ISO. Tous les emplacements au sein de la zone renvoyée sont accessibles au cours d'une durée donnée ou sont plus proches d'une certaine distance le long des routes. Renvoie une table avec un ID, une géométrie de zone de déplacement, un point central, un coût, une unité de coût et un statut (OK ou failed).

Si vous utilisez "bird" comme type de transport, des cercles géographiquement corrects sont générés autour des origines.

Renvoie les colonnes suivantes :

• <dataset key column> - Colonne de clés de l'ensemble de données d'entrée.
• TravelArea - Géométrie polygone qui définit la zone de déplacement.
• Cost - Coût spécifié dans costValue ou costField.
• CostUnit - Unité de coût spécifiée dans costUnit.
• Status - Le statut renvoyé est "OK" ou "failed:", suivi d'un message d'erreur.
• Toutes les colonnes sauf la colonne de clés de l'ensemble de données d'entrée, avec le préfixe du nom d'ensemble de données.

Prend en charge :

• ScriptEval dans les scripts de chargement.
• ScriptEvalStr dans les scripts graphiques pour obtenir la géométrie de la zone de déplacement.
• ScriptEval dans les scripts graphiques pour obtenir le coût.

Cet exemple de script de chargement génère des zones de déplacement de 10 minutes à Miami et à Orlando à partir des coordonnées :

Cet exemple de script de chargement génère des zones de déplacement de 10 minutes à Miami et à Orlando via des points nommés :

Voici un exemple qui calcule les itinéraires de déplacement autour de points directement dans une couche de zones. L'opération est appelée pour la sélection à chaque changement de sélection. Cela doit être placé dans le script de chargement pour charger les données pour l'exemple :

Utilisez la dimension suivante dans la couche de zones :

Utilisez une condition de calcul dans la couche de zones :

Dans la propriété Location, placez ceci :

Renvoie les relations entre deux ensembles de données lorsqu'une géométrie d'un ensemble de données (enclosed) se trouve entièrement à l'intérieur de la zone de l'autre ensemble de données (enclosing). Renvoie une table qui effectue un mappage entre la clé dans enclosed et la clé dans enclosing pour toutes les relations trouvées.

Utilisez within généralement pour rechercher les zones dans lesquelles se trouvent les données ; par exemple, pour tester la position GPS de la région administrative dans laquelle elles se trouvent. Il s'agit d'une sorte de géocodage inversé.

Renvoie les colonnes suivantes :

• <enclosed name>_<enclosing name>_RelationId - Clé générée pour la relation entre les deux géométries.
• <enclosed key column> - Colonne de clés du dataset1 d'entrée.
• <enclosing key column> - Colonne de clés du dataset2 d'entrée.
• Toutes les colonnes sauf la colonne de clés de l'ensemble de données enclosed, avec le préfixe du nom d'ensemble de données.
• Toutes les colonnes sauf la colonne de clés de l'ensemble de données enclosing, avec le préfixe du nom d'ensemble de données.

Prend en charge :

• ScriptEval dans les scripts de chargement.

Pour compenser les inexactitudes des données, il est parfois préférable d'utiliser Closest au lieu de Within. Par exemple, si vous avez des données de points dans des zones côtières que vous souhaitez associer à des régions administratives, de petites imprécisions peuvent placer les points légèrement en dehors des régions.

Voici un exemple de script de chargement qui calcule les points qui se trouvent dans tel ou tel état :