Operacja | Qlik Cloud Pomoc
Przeskocz do zawartości głównej Przejdź do treści uzupełniającej

Operacja

AddressPointLookup

Zwraca geometrie punktowe 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 nie można było znaleźć z jakiegokolwiek powodu, nie są zwracane w wyniku.

Funkcjonalność oferowana 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 wyszukiwanie lokalizacji może być precyzyjne tylko do poziomu kodu pocztowego.

Rozpoczynając pracę z Qlik Geocoding, użyj szablonu, do którego odniesienie znajduje się w Konfigurowanie Qlik Geocoding (tylko w języku angielskim).

Informacja Aby uzyskać najlepsze wyniki, preferuj określone dane i pomijaj ogólne dane, gdy tylko jest to możliwe. Na przykład, jeśli masz zarówno kod pocztowy, jak i miasto pocztowe, i ufasz, że kod pocztowy jest poprawny, najlepiej nie określać miasta pocztowego.

Większość parametrów występuje w dwóch wersjach: jednej określającej rzeczywistą wartość, takiej jak country="SWE", i drugiej określającej nazwę pola, z którego należy pobrać rzeczywistą wartość, takiej jak countryField="CountryIso2".

Informacja Musisz mieć uprawnienie roli użytkownika Use : , aby używać AddressPointLookup.
Informacja Aby geokodować adresy w języku angielskim lub pinyin w Chinach, parametr Country musi być ustawiony na "CHN".

Zwraca następujące kolumny:

  • <dataset key column> - Kolumna klucza z wejściowego zestawu danych.
  • Address - Znaleziony adres, sformatowany zgodnie ze standardami adresowymi danego 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 podziału administracyjnego na poziomie miasta dla znalezionego elementu.
  • Adm1 - Nazwa lub skrócona nazwa podziału administracyjnego pierwszego rzędu (stanu) dla znalezionego elementu.
  • CountryIso2 - Kod kraju dla znalezionego elementu.
  • Match - Wartość od 0 do 1, która pokazuje, jak dobre było dopasowanie. Wartość 1 oznacza idealne dopasowanie.
  • Wszystkie kolumny z wyjątkiem kolumny klucza z dataset, poprzedzone nazwą zestawu danych.

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

Obsługuje:

  • ScriptEval w skryptach ładowania.

Przykład geokodujący niektóre szwedzkie adresy, gdzie każdy element znajduje się we własnym polu:

[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 wolnego 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 dla AddressPointLookup
Parametr Typ Użycie Opis
searchText string opcjonalne Ciąg tekstu do wyszukania. Mogą to być adresy takie jak: "1600 Pennsylvania Ave, Washington DC, USA" lub niekompletne adresy, które są połączone z danymi w innych polach, takimi jak "1117 Washington Ave" z City ustawionym na "Philadelphia" i Country ustawionym na "USA".
searchTextField string opcjonalne Jeśli searchText nie jest określony, ten parametr może być użyty do określenia pola, z którego należy pobrać informacje.
country string opcjonalne Ciąg z trzyliterowymi kodami ISO. Można określić wiele krajów, oddzielając je przecinkami: "SWE,NOR,FIN". Aby geokodować adresy w języku angielskim lub pinyin w Chinach, ten parametr musi być ustawiony na "CHN".
countryField string opcjonalne Jeśli country nie jest określony, ten parametr może być użyty do określenia pola, które zawiera nazwę kraju lub dwu- lub trzyliterowe kody ISO. Należy pamiętać, że w przeciwieństwie do innych parametrów, oczekiwany format danych określony przez country i countryField nie jest identyczny. Parametr country pozwala na wiele krajów, ale tylko w trzyliterowym formacie ISO, podczas gdy countryField pozwala na różne formaty krajów.
state string opcjonalne Nazwa lub kod stanu. W przypadku większości krajów stan nie jest częścią adresu.
stateField string opcjonalne Jeśli state nie jest określony, ten parametr może być użyty do określenia pola, z którego należy pobrać informacje.
city string opcjonalne Nazwa miasta, gmina lub miasto pocztowe.
cityField string opcjonalne Jeśli city nie jest określony, ten parametr może być użyty do określenia pola, z którego należy pobrać informacje.
postalCode string opcjonalne Kod pocztowy.
postalCodeField string opcjonalne Jeśli postalCode nie jest określony, ten parametr może być użyty do określenia pola, z którego należy pobrać informacje.
street string opcjonalne Nazwa ulicy. Zamiast określać ulicę i numer domu w oddzielnych parametrach lub polach, można określić oba razem, oddzielone spacją.
streetField string opcjonalne Jeśli street nie jest określony, ten parametr może być użyty do określenia pola, z którego należy pobrać informacje.
houseNumber string opcjonalne Numer domu.
houseNumberField string opcjonalne Jeśli houseNumber nie jest określony, ten parametr może być użyty do określenia pola, z którego należy pobrać informacje.
matchThreshold real domyślnie:0.5 Zwróć tylko wynik z lepszym dopasowaniem niż to. Zwiększ tę wartość, jeśli zwracanych jest zbyt wiele fałszywych trafień.
language string domyślnie: Brak. Dwuliterowy kod języka dla preferowanego języka adresu w odpowiedzi. Jeśli adres nie jest dostępny w żądanym języku, jest zwracany w domyślnym języku dla lokalizacji.
dataset Dataset domyślnie: Brak. Zestaw danych z adresami, które będą wyszukiwane w geokoderze. Obsługuje strumieniowanie tego zestawu danych po wysłaniu ze skryptu ładowania, co oznacza, że dozwolone są większe tabele.
precision integer domyślnie:6 Ustawia liczbę miejsc dziesiętnych, do których mają być zaokrąglane współrzędne. Domyślna wartość to 6 miejsc dziesiętnych, co daje precyzję do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną.

Binning

Generuje prostokątne lub sześciokątne kosze dla punktowego zestawu danych. Jest to sposób na agregację danych punktowych, dzięki czemu przegląd danych może być wyświetlany wydajnie.

Zwraca następujące kolumny:

  • <dataset key column> - Kolumna klucza z wejściowego zestawu danych.
  • BinId - Tożsamość dla kosza.
  • BinTable.BinPolygon - Wielokąt dla kosza.
  • BinTable.CenterPoint - Punkt w środku kosza.
  • Wszystkie kolumny z wyjątkiem kolumny klucza z dataset, poprzedzone nazwą zestawu danych.

Obsługuje:

  • ScriptEval w skryptach ładowania.

Przykład ładujący sześciokątne kosze z lotnisk w USA:

Load * Extension GeoOperations.ScriptEval(' Binning(type="hexagonal", gridSize="1") DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="us" ');
Parametry dla Binning
Parametr Typ Użycie Opis
type string domyślnie:prostokątne Określa, czy mają być generowane kosze prostokątne czy sześciokątne.
gridSize real domyślnie: Brak. Wysokość pojedynczego kosza w stopniach. Jeden stopień to około 10000 m.
gridWidthHeightRatio real domyślnie:1.5 Stosunek szerokości do wysokości koszy. Kwadratowe kosze są często optymalne, ale różni się to w zależności 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 geograficznej +-30 stopni i 2 na szerokości geograficznej +-60 stopni. Często lepiej wygląda wyświetlanie danych w koszach w rzutowaniu adaptacyjnym niż w rzutowaniu Mercatora.
dataset Dataset domyślnie: Brak. Zestaw danych z geometriami punktowymi, dla których mają być generowane kosze. Obsługuje strumieniowanie tego zestawu danych po wysłaniu ze skryptu ładowania, co oznacza, że dozwolone są większe tabele.
precision integer domyślnie:6 Ustawia liczbę miejsc dziesiętnych, do których mają być zaokrąglane współrzędne. Domyślna wartość to 6 miejsc dziesiętnych, co daje precyzję 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 jakikolwiek jest bliżej niż maksymalna odległość. Koszt można również obliczyć wzdłuż dróg, a w takim przypadku opcjonalnie użyć czasu podróży. Ta operacja jest przydatna w wielu przypadkach, nie tylko do uzyskiwania relacji z najbliższymi obiektami, ale także do uzyskiwania macierzy odległości między zestawem punktów.

Zwraca następujące kolumny:

  • <dataset1 name>_<dataset2 name>_RelationId - Klucz wygenerowany dla relacji między dwiema geometriami.
  • <dataset1 key column> - Kolumna klucza z wejściowego zestawu danych dataset1.
  • <dataset2 key column> - Kolumna klucza z wejściowego zestawu danych dataset2.
  • Distance - Odległość w jednostce określonej w costUnit.
  • Status - Zwrócony status to "ok" lub "failed:" z następującym po nim komunikatem 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 klucza z wejściowego zestawu danych dataset1, poprzedzone nazwą zestawu danych.
  • Wszystkie kolumny z wyjątkiem kolumny klucza z wejściowego zestawu danych dataset2, poprzedzone nazwą zestawu danych.

Obsługuje:

  • ScriptEval w skryptach ładowania.

Ten przykład znajduje najbliższe lotniska dla punktów 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 dla Closest
Parametr Typ Użycie Opis
distance real domyślnie: Brak. Maksymalna odległość od jednostki określonej w jednostce kosztu. Elementy oddalone od siebie bardziej niż ta wartość są ignorowane.
costUnit string domyślnie:metry Powinno to być jedno z: metry, jardy, kilometry, mile, sekundy, minuty lub godziny. Użycie jednostek czasu oznacza, że czas podróży jest używany jako koszt, a jednostki długości oznaczają, że używana jest odległość. Jednostki czasu nie są dozwolone dla typu odległości Bird.
distanceType real domyślnie:Bird Decyduje o tym, jak mierzone są odległości. Dozwolone są następujące wartości:
  • Bird - mierzy bezpośrednie odległości (w linii prostej) między obiektami.
  • Car - mierzy wzdłuż dróg z ograniczeniami dla samochodów. Obsługiwane tylko dla punktowych zestawów danych.
  • Bike - mierzy wzdłuż dróg z ograniczeniami dla rowerów. Obsługiwane tylko dla punktowych zestawów danych.
  • Pedestrian - mierzy wzdłuż dróg z ograniczeniami dla pieszych. Obsługiwane tylko dla punktowych zestawów danych.
  • Truck - mierzy wzdłuż dróg z ograniczeniami dla ciężarówek. Obsługiwane tylko dla punktowych zestawów danych.
closestCount real 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 Dataset domyślnie:<pierwszy zestaw danych> Obiekty do sprawdzenia pod kątem bliskości do obiektów w dataset2, jeśli określono, w przeciwnym razie do obiektów w nim samym. Podczas sprawdzania bliskości między obiektami w pojedynczym zestawie danych relacje nigdy nie są dodawane z obiektu do niego samego. Obsługuje strumieniowanie tego zestawu danych po wysłaniu ze skryptu ładowania i zdefiniowaniu dataset2, co oznacza, że dozwolone są większe tabele.
dataset2 Dataset domyślnie:<drugi zestaw danych, jeśli istnieje> Obiekty do powiązania z obiektami w dataset1.
precision integer domyślnie:6 Ustawia liczbę miejsc dziesiętnych, do których mają być zaokrąglane współrzędne. Domyślna wartość to 6 miejsc dziesiętnych, co daje precyzję do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną.

Cluster

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

Zwraca następujące kolumny:

  • <dataset key column> - Kolumna klucza z wejściowego zestawu danych.
  • ClusterID - Identyfikator klastra, do którego należy punkt.
  • Clusters.ClusterPoint - Punkt środkowy dla klastra.
  • Clusters.PointCount - Liczba oryginalnych punktów należących do klastra.
  • Wszystkie kolumny z wyjątkiem kolumny klucza z wejściowego zestawu danych, poprzedzone nazwą zestawu danych.

Obsługuje:

  • ScriptEval w skryptach ładowania.

Ten przykład grupuje lotniska w USA w klastry, tak aby lotniska znajdujące się bliżej 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 dla Cluster
Parametr Typ Użycie Opis
distance real domyślnie: Brak. Odległość między punktem a jego klastrem nie może być większa niż ta odległość w metrach.
dataset Dataset domyślnie: Brak. Zestaw danych z punktami do klastrowania.
precision integer domyślnie:6 Ustawia liczbę miejsc dziesiętnych, do których mają być zaokrąglane współrzędne. Domyślna wartość to 6 miejsc dziesiętnych, co daje precyzję do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną.

Dissolve

Rozwiązuje i upraszcza obszary w celu utworzenia większych obszarów na podstawie mapowania między starymi tożsamościami obszarów (lub geometriami) a nowymi tożsamościami obszarów. Jest to zazwyczaj używane do budowania niestandardowych obszarów, które składają się z mniejszych, dobrze zdefiniowanych 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 nowych rozwiązanych obszarów.

Obsługuje:

  • ScriptEval w skryptach ładowania.

Zestaw danych geometrii jest opcjonalny. Jeśli nie zostanie podany, zakłada się, że geometrie są dostępne w zestawie danych definicji rozwiązania.

Należy pamiętać, że nakładanie się wielokątów jest usuwane we wszystkich rozdzielczościach z wyjątkiem Source.

Ten przykład tworzy dwa regiony, jeden składający się z CA i AZ, a drugi składający się 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 dla Dissolve
Parametr Typ Użycie Opis
dissolveField string domyślnie:<taka sama nazwa jak pole klucza w dissolveDataset> Nazwa pola z tożsamościami nowych obszarów w dissolveDataset.
resolution string 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ść, która jest niższa niż (połowa) rozdzielczości Auto.
  • autohigh - Rozdzielczość, która jest wyższa niż (podwójna) rozdzielczość Auto.
  • source - Nie jest wykonywane żadne uproszczenie. Należy pamiętać, że jeśli dissolveDataset zawiera te same stare obszary dwukrotnie w dwóch różnych nowych obszarach, należy użyć source.
areaDatasetKeyField string domyślnie:<pole klucza w areaDataset> Tożsamości oryginalnych obszarów w areaDataset. Jest to używane tylko wtedy, gdy określono areaDataset.
dissolveDataset Dataset domyślnie:<pierwszy zestaw danych> Definicja tego, do którego nowego obszaru należy każdy stary obszar, tj. mapowanie między tożsamościami starego i nowego obszaru. Pole klucza powinno mapować do kluczy w areaDataset, jeśli zostało określone. Jeśli nie podano areaDataset, geometrie powinny być dostępne w tym zestawie danych.
areaDataset Dataset domyślnie:<drugi zestaw danych, jeśli istnieje> Zestaw danych z geometriami obszarów do rozwiązania. Może to 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 Ustawia liczbę miejsc dziesiętnych, do których mają być zaokrąglane współrzędne. Domyślna wartość to 6 miejsc dziesiętnych, co daje precyzję do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną.

Intersects

Zwraca tabelę, która mapuje między kluczem w dataset1 a kluczem w dataset2 dla wszystkich obiektów, które się przecinają. Jeśli oba zestawy danych zawierają wielokąty, zwracany jest względny obszar nakładania się w porównaniu do obszarów w odpowiednim zestawie danych.

Możliwe jest ograniczenie liczby przecinających się geometrii w drugim zestawie danych, które powinny być zamapowane na każdą geometrię w pierwszym zestawie danych, określając intersectsCount. Wtedy najbardziej przecinające się geometrie są zwracane w kolejności. Operacja jest symetryczna, jeśli intersectsCount nie jest określony.

Zwraca następujące kolumny:

  • <dataset1 name>_<dataset2 name>_RelationId - Klucz wygenerowany dla relacji między dwiema geometriami.
  • <dataset1 key column> - Kolumna klucza z wejściowego zestawu danych dataset1.
  • <dataset2 key column> - Kolumna klucza z wejściowego zestawu danych dataset2.
  • <dataset1 name>.RelativeOverlap - Nakładanie się w porównaniu do wielokąta w dataset1. Zwracane tylko wtedy, gdy oba zestawy danych zawierają wielokąty. Żądanie tego pola wiąże się ze spadkiem wydajności.
  • <dataset2 name>.RelativeOverlap - Nakładanie się w porównaniu do wielokąta w dataset2. Zwracane tylko wtedy, gdy oba zestawy danych zawierają wielokąty. Żądanie tego pola wiąże się ze spadkiem wydajności.
  • Wszystkie kolumny z wyjątkiem kolumny klucza z wejściowego zestawu danych dataset1, poprzedzone nazwą zestawu danych.
  • Wszystkie kolumny z wyjątkiem kolumny klucza z wejściowego zestawu danych dataset2, poprzedzone nazwą zestawu danych.

Obsługuje:

  • ScriptEval w skryptach ładowania.

Ten przykład oblicza, które stany przecinają niektóre 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 dla Intersects
Parametr Typ Użycie Opis
dataset1 Dataset domyślnie:<pierwszy zestaw danych> Zestaw danych z geometriami do przetestowania, które przecinają geometrie w innym zestawie danych, jeśli został określony, lub między obiektami w tym zestawie danych, jeśli nie. Podczas sprawdzania przecięcia między obiektami w pojedynczym zestawie danych relacje nigdy nie są dodawane z obiektu do niego samego. Obsługuje strumieniowanie tego zestawu danych po wysłaniu ze skryptu ładowania i zdefiniowaniu dataset2, co oznacza, że dozwolone są większe tabele.
dataset2 Dataset domyślnie:<drugi zestaw danych, jeśli istnieje> Zestaw danych z geometriami do przetestowania, które przecinają geometrie w innym zestawie danych. Jeśli nie zostanie określony, obliczane jest przecięcie między obiektami w dataset1.
intersectsCount integer domyślnie:0 Jeśli jest większa niż 0, zwracana jest co najwyżej ta liczba przecinających się geometrii w dataset2 na geometrię dataset1. Zwracane są tylko te, które przecinają się najbardziej (największy obszar nakładania się lub długość).
precision integer domyślnie:6 Ustawia liczbę miejsc dziesiętnych, do których mają być zaokrąglane współrzędne. Domyślna wartość to 6 miejsc dziesiętnych, co daje precyzję 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 punktowe dla adresów IP w tabeli. Jest to przydatne podczas analizowania danych dostępu do usług internetowych. Zwrócona tabela zawiera następujące pola:
  • Pole klucza - Takie samo jak pole klucza dla tabeli nazw.
  • <Address Table Ip Field> - Takie samo jak pole IP, które było wyszukiwane. 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 dla obszaru administracyjnego pierwszego rzędu dla znalezionego elementu. Należy pamiętać, ż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 klucza z wejściowego zestawu danych, poprzedzone nazwą zestawu danych.

Geolokalizacja IP jest z natury nieprecyzyjna. W przypadku wielu adresów IP możliwe jest dokładne określenie miasta, ale w przypadku innych można określić tylko kraj.

Najlepszą praktyką jest wysyłanie tylko kolumny Ip do operacji IpLookup. Przykład wyszukujący 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});

Często zdarza się, że ten sam adres IP powtarza się w wielu wierszach. Wtedy poprawia to wydajność, jeśli najpierw odfiltruje się tylko unikalne 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, dostępne na stronie MaxMind.

Parametry dla IpLookup
Parametr Typ Użycie Opis
ipField string opcjonalne Pole z adresem IP do wyszukania. Używa pola klucza zestawu danych, jeśli nie zostało określone.
dataset Dataset domyślnie: Brak. Zestaw danych z adresami IP, które będą wyszukiwane w geokoderze. Obsługuje strumieniowanie tego zestawu danych po wysłaniu ze skryptu ładowania, co oznacza, że dozwolone są większe tabele.
precision integer domyślnie:6 Ustawia liczbę miejsc dziesiętnych, do których mają być zaokrąglane współrzędne. Domyślna wartość to 6 miejsc dziesiętnych, co daje precyzję do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną.

Load

Ładuje zestaw danych bez zastosowania żadnej operacji. Umożliwia to załadowanie wszystkich formatów obsługiwanych przez GeoOperations. Należy pamiętać, że 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 dataset.

Obsługuje:

  • ScriptEval w skryptach ładowania.

Przykład ładujący kody pocztowe ze Szwecji:

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

Ponieważ WKT jest obsługiwany jako format geometrii dla danych w INTABLE, operacja Load jest doskonała do konwersji geometrii geograficznych załadowanych z bazy danych do formatu geometrii Sense, aby można było je wyświetlić. Poniższy przykład pokazuje, 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 dla Load
Parametr Typ Użycie Opis
dataset Dataset domyślnie:<pierwszy zestaw danych> Zestaw danych do załadowania. Obsługuje strumieniowanie tego zestawu danych po wysłaniu ze skryptu ładowania, co oznacza, że dozwolone są większe tabele.
precision integer domyślnie:6 Ustawia liczbę miejsc dziesiętnych, do których mają być zaokrąglane współrzędne. Domyślna wartość to 6 miejsc dziesiętnych, co daje precyzję 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, znane również jako odwrotne geokodowanie. Ta operacja wymaga specjalnej licencji. Punkty znajdujące się blisko ulic otrzymają adresy na poziomie ulicy, w przeciwnym razie nastąpi powrót do zwracania trafień na poziomie obszaru pocztowego lub miasta. W przypadku punktów znajdujących się zbyt daleko żadne dane nie są zwracane.

Informacja Musisz mieć uprawnienie roli użytkownika Use : , aby używać PointToAddressLookup.

Zwraca następujące kolumny:

  • <dataset key column> - Kolumna klucza z wejściowego zestawu danych.
  • Address - Znaleziony adres, sformatowany zgodnie ze standardami adresowymi danego 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 podziału administracyjnego na poziomie miasta dla znalezionego elementu.
  • Adm1 - Nazwa lub skrócona nazwa podziału administracyjnego pierwszego rzędu (stanu) dla znalezionego elementu.
  • CountryIso2 - Kod kraju dla znalezionego elementu.
  • Distance - Odległość w metrach do znalezionego adresu.
  • Wszystkie kolumny z wyjątkiem kolumny klucza z dataset, poprzedzone nazwą zestawu danych.

Należy pamiętać, że zwrócone pola mogą być puste, jeśli nie mają zastosowania lub gdy dane nie są dostępne.

Przykład pobierający 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 dla PointToAddressLookup
Parametr Typ Użycie Opis
language string domyślnie: Dwuliterowy kod języka dla preferowanego języka adresu w odpowiedzi. Jeśli adres nie jest dostępny w żądanym języku, jest zwracany w domyślnym języku dla lokalizacji.
dataset Dataset domyślnie: Brak. Zestaw danych z punktami, które będą wyszukiwane w geokoderze. Obsługuje strumieniowanie tego zestawu danych po wysłaniu ze skryptu ładowania, co oznacza, że dozwolone są większe tabele.
precision integer domyślnie:6 Ustawia liczbę miejsc dziesiętnych, do których mają być zaokrąglane współrzędne. Domyślna wartość to 6 miejsc dziesiętnych, co daje precyzję 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.

Należy pamiętać, że punktem początkowym jest kolumna geometrii w zestawie danych. Kolumna miejsca docelowego jest określona w parametrach operacji, ponieważ zestawy danych znają tylko jedną kolumnę geometrii.

Jeśli użyjesz bird jako typu transportu, wygeneruje to łuki koła wielkiego między punktami początkowymi i docelowymi.

Zwraca następujące kolumny:

  • <dataset key column> - Kolumna klucza z wejściowego zestawu danych.
  • Distance - Odległość trasy w metrach.
  • Duration - Szacowany czas podróży trasą w sekundach.
  • Status - Zwrócony status to "ok" lub "failed:" z następującym po nim komunikatem o błędzie.
  • LowResLine - Wersja linii trasy o niskiej rozdzielczości.
  • Wszystkie kolumny z wyjątkiem kolumny klucza z wejściowego zestawu danych, poprzedzone nazwą zestawu danych.

Obsługuje:

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

To jest przykład obliczający trasy 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);

To jest przykład obliczający trasy bezpośrednio w warstwie linii. Operacja jest wywoływana dla wyboru za każdym razem, gdy wybór ulegnie zmianie. Zwykle powinien istnieć warunek obliczeniowy, który jest prawdziwy, jeśli wybrano tylko kilka punktów (w przeciwnym razie lepiej jest obliczyć trasy w skrypcie ładowania). Należy to umieścić w skrypcie ładowania, aby załadować dane. 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 Lokalizacja, która powinna być ustawiona na Line geometry, umieść to, aby obliczyć trasy ze stałej pozycji do wybranych punktów:

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

Parametry dla Routes
Parametr Typ Użycie Opis
dataset Dataset domyślnie: Brak. Zestaw danych z punktami początkowymi i docelowymi dla tras do obliczenia. Punkty początkowe powinny znajdować się w geometrii zestawu danych. Obsługuje strumieniowanie tego zestawu danych po wysłaniu ze skryptu ładowania, co oznacza, że dozwolone są większe tabele.
criteria string domyślnie:fastest Wybierz między fastest lub shortest trasą do obliczenia.
transportation string domyślnie:car Tryb transportu, jeden z car, truck, bike, pedestrian lub bird (który leci z prędkością 10 m/s).
destField string domyślnie: Brak. Pole w zestawie danych, które określa miejsce docelowe. Należy pamiętać, że punktem początkowym jest pole geometrii określone w zestawie danych.
geometryType string 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 string domyślnie: Brak. Dla zaawansowanych użytkowników. Określony ciąg jest dołączany do wszystkich identyfikatorów. Jest to wygodny sposób na określenie większej ilości informacji dla usług lokalizacji opartych na serwerze, takich jak kod kraju lub typ. Alternatywą jest dołączenie dodatkowych danych podczas ładowania tabeli do Qlik. Z następującym przyrostkiem wszystkie elementy są określone jako miasta w Szwecji:
,SE:city
Zobacz Location Service Guide, aby uzyskać więcej informacji na temat składni do użycia.
precision integer domyślnie:6 Ustawia liczbę miejsc dziesiętnych, do których mają być zaokrąglane współrzędne. Domyślna wartość to 6 miejsc dziesiętnych, co daje precyzję 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ć bardziej wydajne geometrie, które szybciej się wyświetlają.

Stopień uproszczenia jest obliczany automatycznie na podstawie obszaru, liczby obiektów i rozmiaru obiektów. Następnie można to dostosować do wyższej lub niższej rozdzielczości za pomocą parametru resolution.

Upraszczanie obszarów odbywa się za pomocą algorytmu, który obsługuje topologie i może usuwać luki oraz łączyć wyspy.

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

Należy pamiętać, że nakładanie się wielokątów jest usuwane. W danych wyjściowych nie będzie nakładających się wielokątów.

Zwraca następujące kolumny:

  • <dataset key column> - Kolumna klucza z wejściowego dataset1.
  • Simplified_<geometry column name> - Uproszczone wersje oryginalnych geometrii.
  • Wszystkie kolumny z wyjątkiem kolumny klucza z dataset, poprzedzone nazwą zestawu danych.

Obsługuje:

  • ScriptEval w skryptach ładowania.

Przykład ładujący uproszczone wersje stanów USA:

Load * Extension GeoOperations.ScriptEval(' SELECT LocationDbId, Simplified_LocationPolygon FROM Simplify() DATASOURCE states LOCATIONSERVICE type="State", country="us" ');
Parametry dla Simplify
Parametr Typ Użycie Opis
resolution string 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ść, która jest niższa niż (połowa) rozdzielczości Auto.
  • AutoHigh - Rozdzielczość, która jest wyższa niż (podwójna) rozdzielczość Auto.
dataset Dataset domyślnie:<pierwszy zestaw danych> Zestaw danych z geometriami do uproszczenia.
precision integer domyślnie:6 Ustawia liczbę miejsc dziesiętnych, do których mają być zaokrąglane współrzędne. Domyślna wartość to 6 miejsc dziesiętnych, co daje precyzję do około 10 cm. Jeśli nie chcesz zaokrąglać współrzędnych, ustaw wartość na liczbę ujemną.

TravelAreas

Oblicza obszary ISO czasu podróży. Do wszystkich lokalizacji w zwróconym obszarze można dotrzeć w określonym czasie lub znajdują się one 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śli użyjesz "bird" jako typu transportu, wygeneruje to geograficznie poprawne okręgi wokół punktów początkowych.

Zwraca następujące kolumny:

  • <dataset key column> - Kolumna klucza z wejściowego zestawu danych.
  • TravelArea - Geometria wielokąta, która definiuje 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:" z następującym po nim komunikatem o błędzie.
  • Wszystkie kolumny z wyjątkiem kolumny klucza z wejściowego zestawu danych, poprzedzone nazwą zestawu danych.

Obsługuje:

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

Ten przykład skryptu ładowania generuje 10-minutowe obszary podróży w Miami i Orlando ze 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ład skryptu ładowania generuje 10-minutowe obszary podróży w Miami i Orlando przy użyciu 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 obliczający obszary podróży wokół punktów bezpośrednio w warstwie obszaru. Operacja jest wywoływana dla wyboru za każdym razem, gdy wybór ulegnie zmianie. Należy to umieścić w skrypcie ładowania, aby załadować dane dla przykładu:

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 Lokalizacja umieść to:

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

Parametry dla TravelAreas
Parametr Typ Użycie Opis
dataset Dataset domyślnie:<pierwszy zestaw danych> Zestaw danych z punktami początkowymi i opcjonalnie kosztami dla obliczeń obszaru podróży. Obsługuje strumieniowanie tego zestawu danych po wysłaniu ze skryptu ładowania, co oznacza, że dozwolone są większe tabele.
costValue number domyślnie: Brak. Koszt na granicy zwróconowanego obszaru. Koszt może być długością lub czasem. (Zobacz costUnit poniżej). Alternatywą, która pozwala na indywidualne koszty dla każdego obszaru, jest określenie zamiast tego costField.
costField string domyślnie: Brak. Pole w zestawie danych, które określa koszt. Jest to używane tylko wtedy, gdy costValue jest puste.
costUnit string domyślnie:sekundy Powinno to być jedno z: sekundy, minuty, godziny, metry, jardy, kilometry lub mile. Gdy używana jest jednostka czasu, obliczany jest obszar osiągnięty w tym czasie, a gdy używana jest jednostka długości, obliczany jest obszar z odległością podróży krótszą niż określona.
transportation string domyślnie:car Tryb transportu, jeden z car, truck, bike, pedestrian lub bird (który leci z prędkością 10 m/s).
precision integer domyślnie:6 Ustawia liczbę miejsc dziesiętnych, do których mają być zaokrąglane współrzędne. Domyślna wartość to 6 miejsc dziesiętnych, co daje precyzję 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, w których geometria w jednym zestawie danych (enclosed) znajduje się całkowicie wewnątrz obszaru w drugim zestawie danych (enclosing). Zwraca tabelę, która mapuje między kluczem w enclosed a kluczem w enclosing dla wszystkich znalezionych relacji.

Użyj within zazwyczaj do znajdowania, w jakich obszarach znajdują się dane; na przykład do testowania pozycji GPS pod kątem tego, w jakim obszarze administracyjnym się znajdują. Jest to rodzaj odwrotnego geokodowania.

Zwraca następujące kolumny:

  • <enclosed name>_<enclosing name>_RelationId - Klucz wygenerowany dla relacji między dwiema geometriami.
  • <enclosed key column> - Kolumna klucza z wejściowego zestawu danych dataset1.
  • <enclosing key column> - Kolumna klucza z wejściowego zestawu danych dataset2.
  • Wszystkie kolumny z wyjątkiem kolumny klucza z zestawu danych enclosed, poprzedzone nazwą zestawu danych.
  • Wszystkie kolumny z wyjątkiem kolumny klucza z zestawu danych enclosing, poprzedzone nazwą zestawu danych.

Obsługuje:

  • ScriptEval w skryptach ładowania.

Aby zrekompensować niedokładności w danych, czasami lepiej jest użyć Closest zamiast Within. Na przykład, jeśli masz dane punktowe w obszarach przybrzeżnych, które chcesz powiązać z obszarami administracyjnymi, niewielkie niedokładności mogą sprawić, że punkty znajdą się nieco poza obszarami.

To jest przykład skryptu ładowania, który oblicza, które punkty znajdują się w których 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 dla Within
Parametr Typ Użycie Opis
enclosed Dataset domyślnie:<pierwszy zestaw danych> Zestaw danych z geometriami do przetestowania, przez które obszary są otoczone. Obsługuje strumieniowanie tego zestawu danych po wysłaniu ze skryptu ładowania, co oznacza, że dozwolone są większe tabele.
enclosing Dataset domyślnie:<drugi zestaw danych> Zestaw danych z geometriami obszarów do przetestowania, które geometrie otaczają. Obsługuje strumieniowanie tego zestawu danych po wysłaniu ze skryptu ładowania, co oznacza, że dozwolone są większe tabele.
precision integer domyślnie:6 Ustawia liczbę miejsc dziesiętnych, do których mają być zaokrąglane współrzędne. Domyślna wartość to 6 miejsc dziesiętnych, co daje precyzję 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ć!