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).
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".
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:
Ten przykład pokazuje geokodowanie w stylu wolnego tekstu:
| 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:
| 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:
| 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:
|
| 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:
| 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:
| 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:
|
| 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:
| 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
- 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:
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:
Ten produkt zawiera dane GeoLite2 utworzone przez MaxMind, dostępne na stronie MaxMind.
| 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:
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:
| 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.
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:
| 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:
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:
Użyj następującego wymiaru w warstwie linii:
Użyj warunku obliczeniowego w warstwie linii:
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:
| 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:
| 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:
|
| 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:
Ten przykład skryptu ładowania generuje 10-minutowe obszary podróży w Miami i Orlando przy użyciu nazwanych punktów:
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:
Użyj następującego wymiaru w warstwie obszaru:
Użyj warunku obliczeniowego w warstwie obszaru:
We właściwości Lokalizacja umieść to:
| 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:
| 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ą. |