Przeskocz do zawartości głównej Przejdź do treści uzupełniającej

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).

Informacja Aby uzyskać jak najlepsze wyniki, preferuj konkretne dane i w miarę możliwości pomijaj rozbudowane dane. Jeśli na przykład masz zarówno kod pocztowy, jak i miejscowość pocztową i ufasz, że kod pocztowy jest poprawny, najlepiej nie podawać miejscowości pocztowej.

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".

Informacja Aby geokodować adresy w języku angielskim lub w transkrypcji pinyin w Chinach, parametr Country musi być ustawiony na „CHN”.

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:

[Addresses]: Load * inline [ Id,Country,City,Street,HouseNumber,Postal 1,SE,Gothenburg,Odinsgatan,13,41103 2,SE,,Alfhemsgatan,5,41310 ]; Load * Extension GeoOperations.ScriptEval(' Select Id, Address, AddressPoint From AddressPointLookup(countryField="Country", cityField="City", streetField="Street", houseNumberField="HouseNumber", postalCodeField="Postal") ', Addresses);

Ten przykład pokazuje geokodowanie w stylu dowolnego tekstu:

[Addresses2]: Load * inline [ Id;Address 1;1600 Pennsylvania Avenue NW, Washington, D.C. 20500 2;767 5th Ave, New York, NY 10153 ] (delimiter is ';'); Load * Extension GeoOperations.ScriptEval(' AddressPointLookup(searchTextField="Address", country="USA") ', Addresses2);
Parametry dotyczące AddressPointLookup
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:

Load * Extension GeoOperations.ScriptEval(' Binning(type="hexagonal", gridSize="1") DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="us" ');
Parametry dotyczące grupowania
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:

MyPoints: LOAD * inline " id;point 1;[12,57.7] 2;[12.1,57.7] " (delimiter is ';'); MyClosestAirports: Load * Extension GeoOperations.ScriptEval(' Closest(distance="100000", closestCount="3") DATASOURCE pts INTABLE keyField="id", pointField="point" DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="se" ', MyPoints);
Parametry dotyczące Closest
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:
  • Bird — pomiar odległości bezpośredniej (w linii prostej) między obiektami.
  • Car — pomiar wzdłuż dróg z uwzględnieniem ograniczeń dla samochodów. Obsługiwany tylko w przypadku zestawów danych punktów.
  • Bike — pomiar wzdłuż dróg z uwzględnieniem ograniczeń dla rowerów. Obsługiwany tylko w przypadku zestawów danych punktów.
  • Pedestrian — pomiar wzdłuż dróg z uwzględnieniem ograniczeń dla pieszych. Obsługiwany tylko w przypadku zestawów danych punktów.
  • Truck — pomiar wzdłuż dróg z uwzględnieniem ograniczeń dla samochodów ciężarowych. Obsługiwany tylko w przypadku zestawów danych punktów.
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:

MyClusteredAirports: Load * Extension GeoOperations.ScriptEval(' Cluster(distance="50000") DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="us" ');
Parametry dotyczące Cluster
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:

MySalesRegions: LOAD * inline " Adm1Code;RegionName California;SouthWest Arizona;SouthWest Washington;NorthWest Oregon;NorthWest " (delimiter is ';'); MySalesRegionGeometries: Load * Extension GeoOperations.ScriptEval(' Dissolve(dissolveField="RegionName", areaDatasetKeyField="Name") DATASOURCE states LOCATIONSERVICE type="State", country="us" ', MySalesRegions);
Parametry dotyczące Dissolve
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:
  • auto — operacja oblicza rozdzielczość na podstawie danych.
  • autolow — rozdzielczość niższa (o połowę) od rozdzielczości automatycznej.
  • autohigh — rozdzielczość wyższa (dwukrotnie) od rozdzielczości automatycznej.
  • source — nie jest wykonywane żadne uproszczenie. Zauważ, że jeśli dissolveDataset zawiera dwa razy te same stare obszary w dwóch różnych nowych obszarach, należy użyć source.
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:

MyLines: LOAD * inline " id;line 1;[[-108.1,45.4],[-107.4,44.9]] 2;[[-98.9,40.1],[-100.4,40.9]] " (delimiter is ';'); LinesInStates: Load * Extension GeoOperations.ScriptEval(' SELECT id, states.Name FROM Intersects() DATASOURCE states LOCATIONSERVICE geometry="AREA", type="Admin1", country="us" ', MyLines);
Parametry dotyczące Intersects
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

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:

MyIpData: LOAD * inline " User;Ip Alice;188.12.2.2 Bob;176.77.23.14 " (delimiter is ';'); MyIpPoints: Load * Extension GeoOperations.ScriptEval(' IpLookup(ipField="Ip") ', MyIpData{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:

MyIpData: LOAD * inline " User;Ip Alice;176.77.23.14 Bob;188.12.2.2 Carol;176.77.23.14 Dave;188.12.2.2 Bob;188.12.2.2 Bob;188.12.2.2 " (delimiter is ';'); MyDistinctIpData: Load distinct Ip resident MyIpData; MyIpPoints: Load * Extension GeoOperations.ScriptEval(' IpLookup(ipField="Ip") ', MyDistinctIpData); Drop Table MyDistinctIpData;

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

Parametry dotyczące IpLookup
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:

Load * Extension GeoOperations.ScriptEval('Load() DATASOURCE PostalCodes LOCATIONSERVICE type="PostalCode", country="se"');

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:

MyWKTData: LOAD *inline " id;wkt 1;POINT(-80.204 25.791) 2;POINT(-81.381 28.538)" (delimiter is ';'); Load * Extension GeoOperations.ScriptEval(' Select id, wkt as point From Load() ', MyWKTData);
Parametry dotyczące Load
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:

MyAddressPoints: LOAD * inline " id;point 1;[-108.1,45.4] 2;[-98.9,40.1] 3;[12.1,57.7] " (delimiter is ';'); Load * Extension GeoOperations.ScriptEval(' PointToAddressLookup() ', MyAddressPoints);
Parametry dotyczące PointToAddressLookup
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:

MyRoutePoints: LOAD * inline " routeid;origin;dest 1;[12,57.7];[12,57.8] 2;[12.1,57.7];[12.2,57.7] " (delimiter is ';'); MyRoutes: Load * Extension GeoOperations.ScriptEval('Routes(destField="dest")', MyRoutePoints);

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:

Load * Extension GeoOperations.ScriptEval( 'Load() DATASOURCE Cities LOCATIONSERVICE geometry="POINT", type="City", country="dk"');

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

LocationDbId

Użyj warunku obliczeniowego w warstwie linii:

Count(LocationDbId)<10

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:

=GeoOperations.ScriptEvalStr('SELECT LowResLine from Routes(originField="Me", destField="LocationPoint")', '[11.2,54.8]' as Me, LocationPoint)

Parametry dotyczące Routes
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:

Load * Extension GeoOperations.ScriptEval(' SELECT LocationDbId, Simplified_LocationPolygon FROM Simplify() DATASOURCE states LOCATIONSERVICE type="State", country="us" ');
Parametry dotyczące Simplify
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:
  • Auto — operacja oblicza rozdzielczość na podstawie danych.
  • AutoLow — rozdzielczość niższa (o połowę) od rozdzielczości automatycznej.
  • AutoHigh — rozdzielczość wyższa (dwukrotnie) od rozdzielczości automatycznej.
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:

MyPoints: LOAD * inline " id;point 1;[-80.204,25.791] 2;[-81.381,28.538] " (delimiter is ';'); MyTravelAreas: Load * Extension GeoOperations.ScriptEval( 'SELECT id, TravelArea from TravelAreas(costValue="10", costUnit="Minutes")', MyPoints);

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

MyCities: LOAD * inline " cid;City 1;Miami,US 2;Orlando,FL,US " (delimiter is ';'); Load * Extension GeoOperations.ScriptEval('TravelAreas(costValue="10",costUnit="minutes") DATASOURCE cities INTABLE keyField="City", namedPointField="City"', MyCities {City});

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:

MyAirports: Load * Extension GeoOperations.ScriptEval(' Load() DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="se" ');

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

LocationDbId

Użyj warunku obliczeniowego w warstwie obszaru:

Count(LocationDbId)<10

We właściwości Location wstaw:

=GeoOperations.ScriptEvalStr('Select TravelArea from TravelAreas(costValue="10", costUnit="minutes")', LocationPoint)

Parametry dotyczące TravelAreas
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:

MyPoints: LOAD * inline " id;point 1;[-108.1,45.4] 2;[-98.9,40.1] 3;[12.1,57.7] " (delimiter is ';'); PointsInStates: Load * Extension GeoOperations.ScriptEval(' Within() DATASOURCE states LOCATIONSERVICE geometry="AREA", type="Admin1", country="us" ', MyPoints);
Parametry dotyczące Within
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ą.
 

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać, co możemy poprawić!