Operacja

Zwraca geometrie punktów dla adresów w tabeli, czyli geokodowanie. Określ ciąg adresu we właściwości Search Text lub ustrukturyzowane części w odpowiednich właściwościach, takich jak Country, Street itp. Dozwolone są również kombinacje. Ta operacja wymaga specjalnej licencji. Adresy, których z jakiegoś powodu nie udało się znaleźć, nie są zwracane w wyniku.

Funkcje oferowane przez Qlik Geocoding (za pośrednictwem AddressPointLookup i PointToAddressLookup) różnią się od innych funkcji wyszukiwania lokalizacji. Qlik Geocoding umożliwia wyszukiwanie na poziomie adresu, podczas gdy zwykłe wyszukiwania lokalizacji mają dokładność na poziomie kodu pocztowego.

Rozpoczynając pracę z Qlik Geocoding, użyj szablonu, o którym mowa w sekcji Konfigurowanie Qlik Geocoding (tylko w języku angielskim).

Większość parametrów występuje w dwóch wersjach, z których jedna określa rzeczywistą wartość, np. country="SWE", a druga określa nazwę pola, z którego należy pobrać rzeczywistą wartość, np. countryField="CountryIso2".

Zwraca następujące kolumny:

• <kluczowa kolumna zestawu danych> — kluczowa kolumna z wejściowego zestawu danych.
• Address — znaleziony adres, sformatowany zgodnie ze standardami adresowymi kraju.
• Geometry — punkt dla znalezionego elementu.
• HouseNumber — numer domu dla znalezionego elementu.
• Street — ulica dla znalezionego elementu.
• PostalCode — kod pocztowy dla znalezionego elementu.
• City — nazwa jednostki podziału administracyjnego na poziomie miasta dla znalezionego elementu.
• Adm1 — nazwa lub nazwa skrócona jednostki administracyjnej (stanu) pierwszego rzędu dla znalezionego elementu.
• CountryIso2 — kod kraju dla znalezionego elementu.
• Match — wartość z zakresu od 0 do 1, która wskazuje, jak dobre było dopasowanie. Wartość 1 oznacza idealne dopasowanie.
• Wszystkie kolumny z wyjątkiem kolumny kluczowej z zestawu danych dataset, poprzedzone nazwą zestawu danych.

Zwrócone pola mogą być puste, jeśli operacja nie ma zastosowania lub gdy dane nie są dostępne.

Obsługuje:

• ScriptEval w skryptach ładowania.

Przykład, w którym goeokodowane są szwedzkie adresy z poszczególnymi elementami w osobnych polach:

Ten przykład pokazuje geokodowanie w stylu dowolnego tekstu:

Generuje prostokątne lub sześciokątne grupy dla zestawu danych punktów. Jest to sposób na agregację danych punktów umożliwiający efektywne wyświetlanie przeglądu danych.

Zwraca następujące kolumny:

• <kluczowa kolumna zestawu danych> — kluczowa kolumna z wejściowego zestawu danych.
• BinId — tożsamość dla grupy.
• BinTable.BinPolygon — wielokąt dla grupy.
• BinTable.CenterPoint — punkt w środku grupy.
• Wszystkie kolumny z wyjątkiem kolumny kluczowej z zestawu danych dataset, poprzedzone nazwą zestawu danych.

Obsługuje:

• ScriptEval w skryptach ładowania.

Przykład, w którym ładowane są sześciokątne grupy z lotnisk w USA:

Zwraca relacje i odległości między obiektami w jednym zestawie danych a najbliższymi obiektami w innym, jeśli którykolwiek z nich jest bliższy, niż wynosi maksymalna odległość. Koszt można również obliczyć według odległości wzdłuż dróg i w takim przypadku opcjonalnie wykorzystać czas podróży. Operacja ta jest użyteczna w wielu przypadkach, nie tylko w celu uzyskania relacji z najbliższymi obiektami, ale także w celu uzyskania macierzy odległości między zestawem punktów.

Zwraca następujące kolumny:

• <nazwa zestawu danych1>_<nazwa zestawu danych2>__RelationId — klucz wygenerowany dla relacji między obiema geometriami.
• <kluczowa kolumna zestawu danych dataset1> — kluczowa kolumna z wejściowego zestawu danych dataset1.
• <kluczowa kolumna zestawu danych dataset2> — kluczowa kolumna z wejściowego zestawu danych dataset2.
• Distance — odległość w jednostce określonej w costUnit.
• Status — zwrócony status to „ok” lub „failed”, po czym następuje komunikat o błędzie.
• LowResLine — wersja linii trasy o niskiej rozdzielczości, dostępna tylko dla typów odległości innych niż bird.
• Wszystkie kolumny z wyjątkiem kolumny kluczowej z wejściowego zestawu danych dataset1, poprzedzone nazwą zestawu danych.
• Wszystkie kolumny z wyjątkiem kolumny kluczowej z wejściowego zestawu danych dataset2, poprzedzone nazwą zestawu danych.

Obsługuje:

• ScriptEval w skryptach ładowania.

W tym przykładzie wyszukiwane są lotniska najbliższe punktom w tabeli:

Tworzy klastry z zestawu danych punktów na podstawie bliskości geograficznej między punktami. Generowanie klastra jest kontrolowane przez parametr distance, który określa, jak daleko może znajdować się punkt od klastra, do którego należy. Zwraca tabelę z relacjami między punktami i klastrami. Zwraca również połączoną tabelę o nazwie Clusters z geometriami klastrów. Zawiera pola ClusterID, ClusterCenter (geometria punktów) i PointCount. Pole count zawiera liczbę punktów w klastrze.

Zwraca następujące kolumny:

• <kluczowa kolumna zestawu danych> — kluczowa kolumna z wejściowego zestawu danych.
• ClusterID — identyfikator klastra, do którego należy punkt.
• Clusters.ClusterPoint — punkt centralny klastra.
• Clusters.PointCount — liczba oryginalnych punktów należących do klastra.
• Wszystkie kolumny z wyjątkiem kolumny kluczowej z wejściowego zestawu danych, poprzedzone nazwą zestawu danych.

Obsługuje:

• ScriptEval w skryptach ładowania.

Ten przykład grupuje lotniska w USA, tak aby lotniska znajdujące się w odległości bliższej niż 50 km należały do jednego klastra:

Agreguje i upraszcza obszary w celu utworzenia większych obszarów na podstawie mapowania między tożsamościami (lub geometriami) starych i nowych obszarów. Jest to zwykle używane do budowania obszarów niestandardowych z mniejszych, dobrze określonych obszarów, takich jak obszary pocztowe lub obszary administracyjne.

Zwraca następujące kolumny:

• <dissolveField> — pole określone jako dissolveField w danych wejściowych.
• DissolvedPolygon — geometrie w nowych zagregowanych obszarach.

Obsługuje:

• ScriptEval w skryptach ładowania.

Zestaw danych geometrii jest opcjonalny. Jeśli go nie podano, geometrie powinny być dostępne w zestawie danych definicji agregowania.

Zwróć uwagę, że nakładanie się wielokątów jest usuwane we wszystkich rozdzielczościach z wyjątkiem source.

W tym przykładzie tworzy się dwa regiony — jeden składający się ze stanów CA i AZ, a drugi z WA i OR:

Zwraca tabelę, która odwzorowuje relacje pomiędzy kluczem w zestawie danych dataset1 a kluczem w zestawie danych dataset2 dla wszystkich nakładających się obiektów. Jeśli oba zestawy danych zawierają wielokąty, zwracany jest względny obszar nakładania się w porównaniu z obszarami w odpowiednim zestawie danych.

Określając intersectsCount, można ograniczyć liczbę przecinających się geometrii w drugim zestawie danych, które powinny być mapowane do poszczególnych geometrii w pierwszym zestawie danych. Następnie zwracane są w kolejności najbardziej przecinające się geometrie. Jeżeli nie określi się intersectsCount, operacja jest symetryczna.

Zwraca następujące kolumny:

• <nazwa zestawu danych1>_<nazwa zestawu danych2>__RelationId — klucz wygenerowany dla relacji między obiema geometriami.
• <kluczowa kolumna zestawu danych dataset1> — kluczowa kolumna z wejściowego zestawu danych dataset1.
• <kluczowa kolumna zestawu danych dataset2> — kluczowa kolumna z wejściowego zestawu danych dataset2.
• <nazwa zestawu danych dataset1>.RelativeOverlap — nakładanie się w porównaniu do wielokąta w zestawie danych dataset1. Zwracane tylko wtedy, gdy oba zestawy danych zawierają wielokąty. Żądanie tego pola ma negatywny wpływ na wydajność.
• <nazwa zestawu danych dataset2>.RelativeOverlap — nakładanie się w porównaniu do wielokąta w zestawie danych dataset2. Zwracane tylko wtedy, gdy oba zestawy danych zawierają wielokąty. Żądanie tego pola ma negatywny wpływ na wydajność.
• Wszystkie kolumny z wyjątkiem kolumny kluczowej z wejściowego zestawu danych dataset1, poprzedzone nazwą zestawu danych.
• Wszystkie kolumny z wyjątkiem kolumny kluczowej z wejściowego zestawu danych dataset2, poprzedzone nazwą zestawu danych.

Obsługuje:

• ScriptEval w skryptach ładowania.

W tym przykładzie oblicza się, w których stanach nakładają się pewne linie:

Zwraca informacje o lokalizacji i geometrie punktów dla adresów IP w tabeli. Jest to przydatne podczas analizowania danych dostępu do usług internetowych. Zwracana tabela zawiera następujące pola:

• Pole klucza — takie samo jak pole klucza w tabeli nazw.
• <Address Table Ip Field> — takie samo jak wyszukiwane pole IP. Dostępne tylko wtedy, gdy nie jest takie samo jak pole klucza.
• IpPoint — punkt dla znalezionego elementu.
• CountryIso2 — kod kraju dla znalezionego elementu.
• Adm1Code — kod jednostki administracyjnej pierwszego rzędu dla znalezionego elementu. Pamiętaj, że ten kod nie zawsze jest zgodny z kodem zwracanym przez usługę lokalizacji.
• City — miasto dla znalezionego elementu.
• Wszystkie kolumny z wyjątkiem kolumny kluczowej z wejściowego zestawu danych, poprzedzone nazwą zestawu danych.

Geolokalizacja adresów IP jest z natury nieprecyzyjna. W przypadku wielu adresów IP możliwe jest wskazanie miasta, ale w niektórych przypadkach można określić tylko kraj.

Najlepszą praktyką jest wysyłanie tylko kolumny IP do operacji IpLookup. Przykład, w którym wyszukuje się niektóre adresy IP:

Powtarzanie się tego samego adresu IP w wielu wierszach jest typowe. Następnie poprawia się efektywność, aby najpierw odfiltrować tylko unikatowe adresy IP, jak w tym przykładzie:

Ten produkt zawiera dane GeoLite2 utworzone przez MaxMind i dostępne z witryny MaxMind.

Ładuje zestaw danych bez zastosowania żadnej operacji. Umożliwia to załadowanie wszystkich formatów obsługiwanych przez GeoOperations. Zauważ, że operacja Simplify może być dobrą alternatywą dla Load, jeśli geometrie są szczegółowe i wolno się wyświetlają.

Zwraca następujące kolumny:

• Wszystkie kolumny z zestawu danych dataset.

Obsługuje:

• ScriptEval w skryptach ładowania.

Przykład, w którym ładowane są kody pocztowe ze Szwecji:

Ponieważ WKT jest obsługiwane jako format geometrii danych w INTABLE, operacja Load doskonale nadaje się do konwertowania geometrii geograficznych ładowanych z bazy danych na format geometrii Sense, co umożliwia ich wyświetlanie. W poniższym przykładzie pokazano, jak przekonwertować dane WKT, w tym przypadku z tabeli MyWKTData:

Zwraca najbliższy adres dla punktów na liście. Jest to znane również jako geokodowanie odwrotne. Ta operacja wymaga specjalnej licencji. Punkty, które znajdują się w pobliżu ulic, otrzymają adresy na poziomie ulicy. W przeciwnym razie zwracane będą trafienia na poziomie obszaru pocztowego lub miasta. W przypadku punktów zbyt odległych dane nie są zwracane.

Zwraca następujące kolumny:

• <kluczowa kolumna zestawu danych> — kluczowa kolumna z wejściowego zestawu danych.
• Address — znaleziony adres, sformatowany zgodnie ze standardami adresowymi kraju.
• Geometry — punkt dla znalezionego elementu.
• HouseNumber — numer domu dla znalezionego elementu.
• Street — ulica dla znalezionego elementu.
• PostalCode — kod pocztowy dla znalezionego elementu.
• City — nazwa jednostki podziału administracyjnego na poziomie miasta dla znalezionego elementu.
• Adm1 — nazwa lub nazwa skrócona jednostki administracyjnej (stanu) pierwszego rzędu dla znalezionego elementu.
• CountryIso2 — kod kraju dla znalezionego elementu.
• Distance — odległość w metrach do znalezionego adresu.
• Wszystkie kolumny z wyjątkiem kolumny kluczowej z zestawu danych dataset, poprzedzone nazwą zestawu danych.

Zwróć uwagę, że zwrócone pola mogą być puste, jeśli operacja nie ma zastosowania lub gdy dane nie są dostępne.

Przykład, który pobiera adresy dla niektórych punktów:

Oblicza trasy, w tym długość i czas trwania, między dwiema lokalizacjami w tabeli.

Zauważ, że początkiem jest kolumna geometrii w zestawie danych. Kolumna docelowa jest określona w parametrach operacji, ponieważ w zestawach danych znana jest tylko jedna kolumna geometrii.

Jeżeli jako rodzaju transportu wybierzesz bird, generowane są duże łuki między punktami początkowymi a docelowymi.

Zwraca następujące kolumny:

• <kluczowa kolumna zestawu danych> — kluczowa kolumna z wejściowego zestawu danych.
• Distance — odległość trasy w metrach.
• Duration — szacowany czas podróży w sekundach.
• Status — zwrócony status to „ok” lub „failed”, po czym następuje komunikat o błędzie.
• LowResLine — wersja linii trasy o niskiej rozdzielczości.
• Wszystkie kolumny z wyjątkiem kolumny kluczowej z wejściowego zestawu danych, poprzedzone nazwą zestawu danych.

Obsługuje:

• ScriptEval w skryptach ładowania.
• ScriptEvalStr w skryptach wykresu do pobierania trasy.
• ScriptEval w skryptach wykresu do pobierania odległości lub czasu trwania.

Oto przykład obliczania tras między punktami w zestawie danych:

Oto przykład obliczania tras bezpośrednio w warstwie linii. Ta operacja jest wywoływana na potrzeby wyboru za każdym razem, gdy wybór się zmienia. Zwykle powinien istnieć warunek obliczeniowy, który jest spełniony, jeśli wybrano tylko kilka punktów (w przeciwnym razie lepiej jest obliczyć trasy w skrypcie ładowania). W celu załadowania danych należy to umieścić w skrypcie ładowania. Na przykład:

Użyj następującego wymiaru w warstwie linii:

Użyj warunku obliczeniowego w warstwie linii:

We właściwości Location, która powinna być ustawiona na Line geometry, wstaw to, aby obliczyć trasy od ustalonej pozycji do wybranych punktów:

Upraszcza geometrie linii i obszarów w zestawie danych. Często przydatne jest ładowanie danych geograficznych za pomocą operacji Simplify zamiast operacji Load, aby uzyskać efektywniejsze i szybciej wyświetlane geometrie.

Stopień uproszczenia jest obliczany automatycznie na podstawie powierzchni oraz liczby i wielkości obiektów. Można to następnie dostosować do wyższej lub niższej rozdzielczości za pomocą parametru resolution.

Uproszczenie obszaru odbywa się za pomocą algorytmu, który obsługuje topologie i może usuwać przerwy oraz łączyć wyspy.

Uproszczenie linii odbywa się za pomocą algorytmu redukcji punktów przerwania.

Zauważ, że nakładanie się wielokątów jest usuwane. W wyniku nie będzie nakładających się wielokątów.

Zwraca następujące kolumny:

• <kluczowa kolumna zestawu danych> — kluczowa kolumna z wejściowego zestawu danych dataset1.
• Simplified_<nazwa kolumny geometrii> — uproszczone wersje oryginalnych geometrii.
• Wszystkie kolumny z wyjątkiem kolumny kluczowej z zestawu danych dataset, poprzedzone nazwą zestawu danych.

Obsługuje:

• ScriptEval w skryptach ładowania.

Przykład, w którym ładowane są uproszczone wersje stanów USA:

Oblicza izoobszary czasu podróży. Do wszystkich lokalizacji w obrębie zwróconego obszaru można dojechać w określonym czasie lub znajduje się on bliżej niż określona odległość wzdłuż dróg. Zwraca tabelę z identyfikatorem, geometrią obszaru podróży, punktem środkowym, kosztem, jednostką kosztu i statusem (OK lub failed).

Jeżeli jako rodzaju transportu wybierzesz „bird”, generuje prawidłowe geograficznie kręgi wokół punktów początkowych.

Zwraca następujące kolumny:

• <kluczowa kolumna zestawu danych> — kluczowa kolumna z wejściowego zestawu danych.
• TravelArea — geometria wielokątowa definiująca obszar podróży.
• Cost — koszt określony w costValue lub costField.
• CostUnit — jednostka kosztu określona w costUnit.
• Status — zwrócony status to „OK” lub „failed”, po czym następuje komunikat o błędzie.
• Wszystkie kolumny z wyjątkiem kolumny kluczowej z wejściowego zestawu danych, poprzedzone nazwą zestawu danych.

Obsługuje:

• ScriptEval w skryptach ładowania.
• ScriptEvalStr w skryptach wykresu do pobierania geometrii obszaru podróży.
• ScriptEval w skryptach wykresu do pobierania kosztów.

Ten przykładowy skrypt ładowania generuje obszary 10-minutowej podróży w Miami i Orlando na podstawie współrzędnych:

Ten przykładowy skrypt ładowania generuje obszary 10-minutowej podróży w Miami i Orlando na podstawie nazwanych punktów:

To jest przykład, który oblicza obszary podróży wokół punktów bezpośrednio w warstwie obszaru. Ta operacja jest wywoływana na potrzeby wyboru za każdym razem, gdy wybór się zmienia. W celu załadowania danych przykładu należy to umieścić w skrypcie ładowania:

Użyj następującego wymiaru w warstwie obszaru:

Użyj warunku obliczeniowego w warstwie obszaru:

We właściwości Location wstaw:

Zwraca relacje między dwoma zestawami danych, takimi, że geometria w jednym zestawie danych (zawartym) znajduje się całkowicie wewnątrz obszaru w drugim zestawie danych (zawierającym). Zwraca tabelę, która odwzorowuje relacje pomiędzy kluczem w zawartym zestawie danych a kluczem w zawierającym zestawie danych dla wszystkich znalezionych relacji.

Używane zwykle do znajdowania obszarów, w których znajdują się dane, na przykład aby przetestować pozycję GPS w celu ustalenia, w jakim obszarze administracyjnym się znajdują Jest to rodzaj geokodowania odwrotnego

Zwraca następujące kolumny:

• <nazwa zawartego zestawu danych>_<nazwa zawierającego zestawu danych>__RelationId — klucz wygenerowany dla relacji między obiema geometriami.
• <kluczowa kolumna zawartego zestawu danych> — kluczowa kolumna z wejściowego zestawu danych dataset1.
• <kluczowa kolumna zawierającego zestawu danych> — kluczowa kolumna z wejściowego zestawu danych dataset2.
• Wszystkie kolumny oprócz kolumny kluczowej z zawartego zestawu danych, poprzedzone nazwą zestawu danych.
• Wszystkie kolumny z wyjątkiem kolumny kluczowej z zawierającego zestawu danych, poprzedzone nazwą zestawu danych.

Obsługuje:

• ScriptEval w skryptach ładowania.

Aby zrekompensować niedokładności danych, czasami lepiej jest użyć opcji Closest zamiast Within. Jeżeli na przykład masz dane punktowe w obszarach kosztowych, które chcesz odnieść do obszarów administracyjnych, drobne niedokładności mogą sprawić, że punkty znajdą się nieco poza obszarami.

To jest przykładowy skrypt ładowania obliczający, które punkty znajdują się w jakich stanach: