Operacja
AddressPointLookup
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:
Parametr | Typ | Użycie | Opis |
---|---|---|---|
searchText | ciąg znaków | opcjonalne | Ciąg znaków tekstu do wyszukania. Mogą to być adresy takie jak: „1600 Pennsylvania Ave, Washington DC, USA” lub niekompletne adresy połączone z danymi w innych polach, np. „1117 Washington Ave”, z wartością City ustawioną na „Philadelphia” i Country ustawioną na „USA”. |
searchTextField | ciąg znaków | opcjonalne | Jeśli nie określono parametru searchText, można go użyć do określenia pola, z którego mają być pobierane informacje. |
country | ciąg znaków | opcjonalne | Ciąg z trzyliterowymi kodami ISO. Można określić większą liczbę krajów oddzielonych przecinkami: „SWE,NOR,FIN”. Aby geokodować adresy w języku angielskim lub w transkrypcji pinyin w Chinach, ten parametr musi być ustawiony na „CHN”. |
countryField | ciąg znaków | opcjonalne | Jeśli nie określono parametru country, można go użyć do określenia pola, które zawiera nazwę kraju lub dwu- albo trzycyfrowe kody ISO. Należy zauważyć, że w przeciwieństwie do innych parametrów oczekiwany format danych określony przez country i countryField nie jest identyczny. Parametr country dopuszcza wiele krajów, ale tylko w trzyliterowym formacie ISO, podczas gdy countryField dopuszcza różne formaty krajów. |
state | ciąg znaków | opcjonalne | Nazwa lub kod stanu. W większości krajów stan nie jest elementem adresu. |
stateField | ciąg znaków | opcjonalne | Jeśli nie określono parametru state, można go użyć do określenia pola, z którego mają być pobierane informacje. |
city | ciąg znaków | opcjonalne | Nazwa miasta, gmina lub miejscowość pocztowa. |
cityField | ciąg znaków | opcjonalne | Jeśli nie określono parametru city, można go użyć do określenia pola, z którego mają być pobierane informacje. |
postalCode | ciąg znaków | opcjonalne | Kod pocztowy. |
postalCodeField | ciąg znaków | opcjonalne | Jeśli nie określono parametru postalCode, można go użyć do określenia pola, z którego mają być pobierane informacje. |
street | ciąg znaków | opcjonalne | Nazwa ulicy. Zamiast podawania ulicy i numeru domu w osobnych parametrach lub polach można je podać oba razem, oddzielone spacją. |
streetField | ciąg znaków | opcjonalne | Jeśli nie określono parametru street, można go użyć do określenia pola, z którego mają być pobierane informacje. |
houseNumber | ciąg znaków | opcjonalne | Numer domu. |
houseNumberField | ciąg znaków | opcjonalne | Jeśli nie określono parametru houseNumber, można go użyć do określenia pola, z którego mają być pobierane informacje. |
matchThreshold | liczba rzeczywista | domyślnie: 0.5 | Zwracany jest tylko wynik z lepszym dopasowaniem niż to. Zwiększ tę wartość, jeśli zwracanych jest zbyt wiele fałszywych trafień. |
Język | ciąg znaków | domyślnie: brak. | Dwuliterowy kod preferowanego języka adresu w odpowiedzi. Jeśli adres nie jest dostępny w żądanym języku, jest zwracany w domyślnym języku lokalizacji. |
dataset | Zestaw danych | domyślnie: brak. | Zestaw danych z adresami, które będą wyszukiwane w geokoderze. Obsługuje przesyłanie strumieniowe tego zestawu danych, jeżeli jest przesyłany ze skryptu ładowania, co oznacza, że dozwolone są większe tabele. |
precision | integer | domyślnie: 6 | Określa żądaną liczbę miejsc dziesiętnych do zaokrąglenia we współrzędnych. Wartość domyślna to 6 miejsc po przecinku, czyli z dokładnością do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną. |
Grupowanie
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:
Parametr | Typ | Użycie | Opis |
---|---|---|---|
type | ciąg znaków | domyślnie: rectangular | Definiuje, czy mają być generowane grupy prostokątne czy sześcienne. |
gridSize | liczba rzeczywista | domyślnie: brak. | Wysokość pojedynczej grupy w stopniach. Jeden stopień to około 10000 m. |
gridWidthHeightRatio | liczba rzeczywista | domyślnie: 1.5 | Stosunek szerokości do wysokości grup. Optymalne są często grupy kwadratowe, ale zależy to od szerokości geograficznej. Wzór na optymalny stosunek szerokości do wysokości to 1/cos(szerokość geograficzna), na przykład 1 na równiku, 1,15 na szerokości –30° i 2 na szerokości –60°. Często lepiej wygląda wyświetlanie danych z grup w odwzorowaniu adaptacyjnym niż w odwzorowaniu walcowym równokątnym. |
dataset | Zestaw danych | domyślnie: brak. | Zestaw danych z geometriami punktów, dla którego mają być generowane grupy. Obsługuje przesyłanie strumieniowe tego zestawu danych, jeżeli jest przesyłany ze skryptu ładowania, co oznacza, że dozwolone są większe tabele. |
precision | integer | domyślnie: 6 | Określa żądaną liczbę miejsc dziesiętnych do zaokrąglenia we współrzędnych. Wartość domyślna to 6 miejsc po przecinku, czyli z dokładnością do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną. |
Closest
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:
Parametr | Typ | Użycie | Opis |
---|---|---|---|
distance | liczba rzeczywista | domyślnie: brak. | Maksymalna odległość w jednostce określonej w Cost unit. Przedmioty znajdujące się dalej od siebie są ignorowane. |
costUnit | ciąg znaków | domyślnie: meters | Jednostką powinny być metry, jardy, kilometry, mile, sekundy, minuty lub godziny. Korzystanie z jednostek czasu oznacza, że czas podróży jest używany jako jednostka kosztu i długości w przypadku danej odległości. Jednostki czasu nie są dozwolone w przypadku odległości typu bird. |
distanceType | liczba rzeczywista | domyślnie: Bird | Decyduje o sposobie pomiaru odległości. Dozwolone są następujące wartości:
|
closestCount | liczba rzeczywista | domyślnie: 1 | Liczba obiektów w drugim zestawie danych do powiązania z obiektem w pierwszym zestawie danych. Wartość 1 oznacza tylko najbliższy, 2 oznacza dwa najbliższe i tak dalej. |
dataset1 | Zestaw danych | domyślnie: <pierwszy zestaw danych> | Obiekty do sprawdzenia bliskości względem obiektów w zestawie danych dataset2, jeśli zostały określone. W przeciwnym razie względem obiektów w tym samym zestawie. Podczas sprawdzania bliskości między obiektami w pojedynczym zestawie danych relacje nigdy nie są dodawane z obiektu do samego siebie. Obsługuje przesyłanie strumieniowe tego zestawu danych, jeżeli jest przesyłany ze skryptu ładowania i kiedy jest zdefiniowany zestaw danych dataset2, co oznacza, że dozwolone są większe tabele. |
dataset2 | Zestaw danych | domyślnie: <drugi zestaw danych, jeżeli istnieje> | Obiekty do powiązania z obiektami w zestawie danych dataset1. |
precision | integer | domyślnie: 6 | Określa żądaną liczbę miejsc dziesiętnych do zaokrąglenia we współrzędnych. Wartość domyślna to 6 miejsc po przecinku, czyli z dokładnością do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną. |
Cluster
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:
Parametr | Typ | Użycie | Opis |
---|---|---|---|
distance | liczba rzeczywista | domyślnie: brak. | Odległość między punktem a jego klastrem nie może być dłuższa niż ta odległość w metrach. |
dataset | Zestaw danych | domyślnie: brak. | Zestaw danych z punktami dodawanymi do klastra. |
precision | integer | domyślnie: 6 | Określa żądaną liczbę miejsc dziesiętnych do zaokrąglenia we współrzędnych. Wartość domyślna to 6 miejsc po przecinku, czyli z dokładnością do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną. |
Dissolve
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:
Parametr | Typ | Użycie | Opis |
---|---|---|---|
dissolveField | ciąg znaków | domyślnie: <ta sama nazwa co pole kluczowe w dissolveDataset> | Nazwa pola z tożsamościami nowych obszarów w dissolveDataset. |
resolution | ciąg znaków | domyślnie: Auto | Wynikowy zestaw danych jest uproszczony, a stopień uproszczenia jest kontrolowany przez tę właściwość. Dostępne wartości to:
|
areaDatasetKeyField | ciąg znaków | domyślnie: <pole kluczowe w areaDataset> | Tożsamości pierwotnych obszarów w areaDataset. Jest to używane tylko wtedy, gdy określono areaDataset. |
dissolveDataset | Zestaw danych | domyślnie: <pierwszy zestaw danych> | Definicja, do którego nowego obszaru należy każdy stary obszar, tzn. mapowanie między tożsamościami starego i nowego obszaru. Pole klucza powinno być mapowane na klucze w zestawie areaDataset, jeśli został określony. Jeśli nie określono areaDataset, geometrie powinny być dostępne w tym zestawie danych. |
areaDataset | Zestaw danych | domyślnie: <drugi zestaw danych, jeżeli istnieje> | Zestaw danych z geometriami obszaru do zagregowania. Wartością może być brak, co oznacza, że geometrie powinny być dostępne w dissolveDataset. Pole areaDatasetKeyField w tym zestawie danych musi być połączone z polem klucza w dissolveDataset. |
precision | integer | domyślnie: 6 | Określa żądaną liczbę miejsc dziesiętnych do zaokrąglenia we współrzędnych. Wartość domyślna to 6 miejsc po przecinku, czyli z dokładnością do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną. |
Intersects
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:
Parametr | Typ | Użycie | Opis |
---|---|---|---|
dataset1 | Zestaw danych | domyślnie: <pierwszy zestaw danych> | Zestaw danych z geometriami do przetestowania pod kątem nakładania się z geometriami z drugiego zestawu danych, jeżeli został określony. W przeciwnym razie — pomiędzy obiektami w tym zestawie danych. Podczas sprawdzania nakładania się między obiektami w pojedynczym zestawie danych relacje nigdy nie są dodawane z obiektu do samego siebie. Obsługuje przesyłanie strumieniowe tego zestawu danych, jeżeli jest przesyłany ze skryptu ładowania i kiedy jest zdefiniowany zestaw danych dataset2, co oznacza, że dozwolone są większe tabele. |
dataset2 | Zestaw danych | domyślnie: <drugi zestaw danych, jeżeli istnieje> | Zestaw danych z geometriami do przetestowania pod kątem przecinania się z geometriami z drugiego zestawu danych. Jeśli nie zostało to określone, obliczane jest nakładanie się obiektów w zestawie danych dataset1. |
intersectsCount | integer | domyślnie: 0 | Jeśli wartość jest większa niż 0, to co najwyżej ta liczba nakładających się geometrii w zestawie danych dataset2 jest zwracana w odniesieniu do geometrii zestawu danych dataset1. Zwracane są tylko te, które nakładają się najbardziej (największy obszar nakładania się lub długość). |
precision | integer | domyślnie: 6 | Określa żądaną liczbę miejsc dziesiętnych do zaokrąglenia we współrzędnych. Wartość domyślna to 6 miejsc po przecinku, czyli z dokładnością do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną. |
IpLookup
- 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.
Parametr | Typ | Użycie | Opis |
---|---|---|---|
ipField | ciąg znaków | opcjonalne | Pole z adresem IP do wyszukania. Używa pola kluczowego zestawu danych, jeśli nie zostało określone. |
dataset | Zestaw danych | domyślnie: brak. | Zestaw danych z adresami IP, które będą wyszukiwane w geokoderze. Obsługuje przesyłanie strumieniowe tego zestawu danych, jeżeli jest przesyłany ze skryptu ładowania, co oznacza, że dozwolone są większe tabele. |
precision | integer | domyślnie: 6 | Określa żądaną liczbę miejsc dziesiętnych do zaokrąglenia we współrzędnych. Wartość domyślna to 6 miejsc po przecinku, czyli z dokładnością do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną. |
Ładuj
Ł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:
Parametr | Typ | Użycie | Opis |
---|---|---|---|
dataset | Zestaw danych | domyślnie: <pierwszy zestaw danych> | Zestaw danych do załadowania. Obsługuje przesyłanie strumieniowe tego zestawu danych, jeżeli jest przesyłany ze skryptu ładowania, co oznacza, że dozwolone są większe tabele. |
precision | integer | domyślnie: 6 | Określa żądaną liczbę miejsc dziesiętnych do zaokrąglenia we współrzędnych. Wartość domyślna to 6 miejsc po przecinku, czyli z dokładnością do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną. |
PointToAddressLookup
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:
Parametr | Typ | Użycie | Opis |
---|---|---|---|
language | ciąg znaków | domyślnie: | Dwuliterowy kod preferowanego języka adresu w odpowiedzi. Jeśli adres nie jest dostępny w żądanym języku, jest zwracany w domyślnym języku lokalizacji. |
dataset | Zestaw danych | domyślnie: brak. | Zestaw danych z punktami, które zostaną wyszukane w geokoderze. Obsługuje przesyłanie strumieniowe tego zestawu danych, jeżeli jest przesyłany ze skryptu ładowania, co oznacza, że dozwolone są większe tabele. |
precision | integer | domyślnie: 6 | Określa żądaną liczbę miejsc dziesiętnych do zaokrąglenia we współrzędnych. Wartość domyślna to 6 miejsc po przecinku, czyli z dokładnością do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną. |
Routes
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:
Parametr | Typ | Użycie | Opis |
---|---|---|---|
dataset | Zestaw danych | domyślnie: brak. | Zestaw danych z punktami początkowymi i docelowymi do obliczania tras. Punkty początkowe powinny znajdować się w geometrii zestawu danych. Obsługuje przesyłanie strumieniowe tego zestawu danych, jeżeli jest przesyłany ze skryptu ładowania, co oznacza, że dozwolone są większe tabele. |
criteria | ciąg znaków | domyślnie: fastest | Wybierz najszybszą lub najkrótszą trasę do obliczenia. |
transportation | ciąg znaków | domyślnie: car | Rodzaj transportu: car, truck, bike, pedestrian lub bird (ptak, który leci z prędkością 10 m/s). |
destField | ciąg znaków | domyślnie: brak. | Pole w zestawie danych, które określa miejsce docelowe. Zauważ, że źródłem jest pole geometrii określone w zestawie danych. |
geometryType | ciąg znaków | domyślnie: POINT | Typ geometrii w destField. Dozwolone wartości to Point, NamedPoint i LatLon. W przypadku nazwanych punktów geometria jest wyszukiwana w usłudze lokalizacji i dodawana jest kolumna dla geometrii. |
suffix | ciąg znaków | domyślnie: brak. | Dla użytkowników zaawansowanych. Podany ciąg jest dołączany do wszystkich identyfikatorów. Jest to wygodny sposób podawania dodatkowych informacji, takich jak kod kraju lub typ, do usług lokalizacyjnych opartych na serwerze. Alternatywą jest dołączanie dodatkowych danych podczas ładowania tabeli do Qlik. Przy użyciu następującego sufiksu wszystkie elementy określane są jako miasta w Szwecji: ,SE:city Więcej informacji na temat składni można znaleźć w Przewodniku po usłudze lokalizacji. |
precision | integer | domyślnie: 6 | Określa żądaną liczbę miejsc dziesiętnych do zaokrąglenia we współrzędnych. Wartość domyślna to 6 miejsc po przecinku, czyli z dokładnością do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną. |
Simplify
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:
Parametr | Typ | Użycie | Opis |
---|---|---|---|
resolution | ciąg znaków | domyślnie: Auto | Wynikowy zestaw danych jest uproszczony, a stopień uproszczenia jest kontrolowany przez tę właściwość. Dostępne wartości to:
|
dataset | Zestaw danych | domyślnie: <pierwszy zestaw danych> | Zestaw danych z geometriami do uproszczenia. |
precision | integer | domyślnie: 6 | Określa żądaną liczbę miejsc dziesiętnych do zaokrąglenia we współrzędnych. Wartość domyślna to 6 miejsc po przecinku, czyli z dokładnością do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną. |
TravelAreas
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:
Parametr | Typ | Użycie | Opis |
---|---|---|---|
dataset | Zestaw danych | domyślnie: <pierwszy zestaw danych> | Zestaw danych z początkiem i opcjonalnie kosztami do obliczania obszaru podróży. Obsługuje przesyłanie strumieniowe tego zestawu danych, jeżeli jest przesyłany ze skryptu ładowania, co oznacza, że dozwolone są większe tabele. |
costValue | liczba | domyślnie: brak. | Koszt na granicy zwróconego obszaru. Koszt może być długością lub czasem. (Patrz costUnit poniżej). Alternatywą, która umożliwia stosowanie indywidualnych kosztów dla każdego obszaru, jest określenie zamiast tego costField. |
costField | ciąg znaków | domyślnie: brak. | Pole w zestawie danych określające koszt. Jest używane tylko wtedy, gdy wartość costValue jest pusta. |
costUnit | ciąg znaków | domyślnie: seconds | Powinno być jedną z jednostek: sekundy, minuty, godziny, metry, jardy, kilometry, mile. Jeśli używana jest jednostka czasu, obliczany jest obszar osiągany w tym czasie, a jeśli używana jest jednostka długości, obliczany jest obszar o dystansie podróży krótszym niż określona odległość. |
transportation | ciąg znaków | domyślnie: car | Rodzaj transportu: car, truck, bike, pedestrian lub bird (ptak, który leci z prędkością 10 m/s). |
precision | integer | domyślnie: 6 | Określa żądaną liczbę miejsc dziesiętnych do zaokrąglenia we współrzędnych. Wartość domyślna to 6 miejsc po przecinku, czyli z dokładnością do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną. |
Within
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:
Parametr | Typ | Użycie | Opis |
---|---|---|---|
enclosed | Zestaw danych | domyślnie: <pierwszy zestaw danych> | Zestaw danych z geometriami do przetestowania pod kątem zawierających je obszarów. Obsługuje przesyłanie strumieniowe tego zestawu danych, jeżeli jest przesyłany ze skryptu ładowania, co oznacza, że dozwolone są większe tabele. |
enclosing | Zestaw danych | domyślnie: <drugi zestaw danych> | Zestaw danych z geometriami obszarów do sprawdzenia, które geometrie one zawierają. Obsługuje przesyłanie strumieniowe tego zestawu danych, jeżeli jest przesyłany ze skryptu ładowania, co oznacza, że dozwolone są większe tabele. |
precision | integer | domyślnie: 6 | Określa żądaną liczbę miejsc dziesiętnych do zaokrąglenia we współrzędnych. Wartość domyślna to 6 miejsc po przecinku, czyli z dokładnością do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną. |