Gå till huvudinnehåll Gå till ytterligare innehåll

Operation

AddressPointLookup

Returnerar punktgeometrier för adresser i en tabell, dvs. geokodning. Ange antingen en adressträng i egenskapen Sök Text eller strukturerade delar i motsvarande egenskaper, till exempel land, gata etc. Kombinationer är också tillåtna. Den här operationen kräver en särskild licens. Adresser som inte kunde hittas av någon anledning returneras inte i resultatet.

Funktionerna som erbjuds av Qlik Geocoding (via AddressPointLookup och PointToAddressLookup) skiljer sig från andra funktioner för platssökning. Qlik Geocoding tillåter sökning på adressnivå, där vanliga platssökningar bara är så exakta som postnummernivån.

Använd den mall som Konfigurering av Qlik Geocoding (endast på engelska) hänvisar till, när du börjar arbeta med Geocoding.

Anteckning om information Bäst resultat får du om du lyfter fram specifika data och utesluter breda data. Om du till exempel har både ett postnummer och en poststad, och du litar på att postnumret är korrekt, är det bäst att inte ange poststaden.

De flesta parametrar finns i två versioner, en som anger det verkliga värdet, som country="SWE", och en som anger ett fältnamn varifrån det verkliga värdet ska hämtas, som countryField="CountryIso2".

Anteckning om information För att skapa geokod för engelska eller Pinyin-adresser i Kina måste parametern Land vara inställd på "CHN".

Returnerar följande kolumner:

  • <dataset key column> – nyckelkolumnen från datauppsättningen med indata.
  • Address – hittad adress, formaterad enligt landets adresstandard.
  • Geometry – punkten för hittat element.
  • HouseNumber – husnummer för hittat element.
  • Street – gatan för hittat element.
  • PostalCode – postnumret för hittat element.
  • City – namnet på förvaltningsenheten på ortnivå för hittat element.
  • Adm1 – namnet eller en förkortning av namnet på första nivåns förvaltningsenhet (delstat) för hittat element.
  • CountryIso2 – landskoden för hittat element.
  • Match – ett värde mellan 0 och 1 som visar hur bra matchningen var. Ett värde på 1 betyder en perfekt matchning.
  • Alla kolumner förutom nyckelkolumnen från datauppsättningen, med datauppsättningens namn som prefix.

De returnerade fälten kan vara tomma om ej tillämpligt eller när inga data är tillgängliga.

Stödjer:

  • ScriptEval i laddningsskript.

Exempel med skapande av geokoder för några svenska adresser där varje element finns i varje eget fält:

[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);

Det här exemplet visar geokodning som fritext:

[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);
Parametrar för AddressPointLookup
Parameter Typ Användning Beskrivning
searchText sträng valfritt En sträng med text att söka efter. Kan vara adresser som: ”1600 Pennsylvania Ave, Washington DC, USA” eller ofullständiga adresser som kombineras med data inom andra fält, som ”1117 Washington Ave” med ort inställt på ”Philadelphia” och land inställt på ”USA”.
searchTextField sträng valfritt Om sökText inte är angiven kan denna parameter användas för att ange ett fält där informationen ska hämtas.
land sträng valfritt En sträng med ISO-koder med tre bokstäver. Flera länder kan specificeras separerade med kommatecken: "SWE,NOR,FIN". För att skapa geokod för engelska eller Pinyin-adresser i Kina måste parametern Land vara inställd på "CHN".
countryField sträng valfritt Om land inte har angetts kan denna parameter användas för att ange ett fält som innehåller landets namn eller ISO-koder med två eller tre bokstäver. Observera att i motsats till de andra parametrarna är det förväntade formatet för data som anges av land och landsFält inte identiskt. Parametern land tillåter flera länder, men bara i ISO-format med tre bokstäver och landsFält tillåter olika landsformat.
state sträng valfritt Statens namn eller kod. För de flesta länder är delstaten inte en del av adressen.
stateField sträng valfritt Om delstat inte är angivet kan denna parameter användas för att ange ett fält där informationen ska hämtas.
city sträng valfritt Ortnamn, kommun eller poststad.
cityField sträng valfritt Om ort inte är angivet kan denna parameter användas för att ange ett fält där informationen ska hämtas.
postalCode sträng valfritt Postnummer.
postalCodeField sträng valfritt Om postNummer inte är angivet kan denna parameter användas för att ange ett fält där informationen ska hämtas.
street sträng valfritt Gatunamn. Istället för att ange gatu- och husnummer i separata parametrar eller fält kan båda anges tillsammans, åtskilda av ett mellanslag.
streetField sträng valfritt Om gata inte är angivet kan denna parameter användas för att ange ett fält där informationen ska hämtas.
houseNumber sträng valfritt Husnummer.
houseNumberField sträng valfritt Om husNummer inte är angivet kan denna parameter användas för att ange ett fält där informationen ska hämtas.
matchThreshold real standardvärde: 0,5 Returnera endast resultat med en bättre matchning än detta. Öka detta värde om för många falska träffar returneras.
language sträng standard: Ingen. En språkkod med två bokstäver för det föredragna språket för adressen i svaret. Om inte adressen är tillgänglig på önskat språk returneras den med platsens standardspråk.
dataset Datauppsättning standard: Ingen. En datauppsättning med adresser som ska slås upp i geokodaren. Stöder strömning av denna datauppsättning när den skickas från laddningsskriptet, vilket innebär att större tabeller kan användas.
precision heltal standardvärde: 6 Ställer in antalet avrundningsdecimaler i koordinater. Standardvärdet är 6 decimaler, vilket motsvarar en precision på ungefär 10 cm. Om du inte vill att koordinater ska avrundas anger du ett negativt värde.

Samla

Genererar rektangulära eller sexkantiga fält för ett punktdataset. Detta är ett sätt att aggregera punktdata så att en översikt över data kan visas effektivt.

Returnerar följande kolumner:

  • <dataset key column> – nyckelkolumnen från datauppsättningen med indata.
  • BinId – identitet för lagerplatsen.
  • BinTable.BinPolygon – polygonen för lagerplatsen.
  • BinTable.CenterPoint – punkten i mitten av lagerplatsen.
  • Alla kolumner förutom nyckelkolumnen från datauppsättningen, med datauppsättningens namn som prefix.

Stödjer:

  • ScriptEval i laddningsskript.

Exempel som laddar sexkantiga fält från amerikanska flygplatser:

Load * Extension GeoOperations.ScriptEval(' Binning(type="hexagonal", gridSize="1") DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="us" ');
Parametrar för Binning
Parameter Typ Användning Beskrivning
typ sträng standardvärde: rektangulär Definierar om rektangulära eller hexagonala bins ska genereras.
gridSize real standard: Ingen. Höjden på en individuell lagerplats i grader. En grad är cirka 10 000 m.
gridWidthHeightRatio real standardvärde: 1,5 Breddens höjdförhållande mellan lagerplatser. Fyrkantiga lagerplatser är ofta optimalt men det varierar med latitud. Formeln för det optimala bredd-höjdförhållandet är 1/cos (latitud), till exempel 1 vid ekvatorn, 1,15 vid latitud +-30 grader och 2 vid latitud +-60 grader. Det ser ofta bättre ut att visa inbyggda data i den adaptiva projektionen än i Mercator-projektionen.
dataset Datauppsättning standard: Ingen. Datauppsättningen med punktgeometrier som lagerplatser ska genereras för. Stöder strömning av denna datauppsättning när den skickas från laddningsskriptet, vilket innebär att större tabeller kan användas.
precision heltal standardvärde: 6 Ställer in antalet avrundningsdecimaler i koordinater. Standardvärdet är 6 decimaler, vilket motsvarar en precision på ungefär 10 cm. Om du inte vill att koordinater ska avrundas anger du ett negativt värde.

Closest

Returnerar relationer och avstånd mellan objekt i en datauppsättning och de närmaste objekten i en annan, om någon är närmare än det maximala avståndet. Kostnaden kan också beräknas längs vägar, och i så fall finns möjlighet att använda sig av restid. Denna åtgärd är användbar i många fall, inte bara för att få relationerna till de närmaste objekten, utan också för att få avståndsmatriser mellan en uppsättning punkter.

Returnerar följande kolumner:

  • <dataset1 name>_<dataset2 name>_RelationId – en nyckel som genererats för relationen mellan de två geometrierna.
  • <dataset1 key column> – nyckelkolumnen från dataset1 med indata.
  • <dataset2 key column> – nyckelkolumnen från dataset2 med indata.
  • Distance – Avståndet i den enhet som specificeras i costUnit.
  • Status – returnerad status är antingen "ok" eller "failed:" åtföljt av ett felmeddelande.
  • LowResLine - en lågupplöst version av ruttlinjen, endast tillgänglig för avståndstyper som inte är fågelvägen.
  • Alla kolumner förutom nyckelkolumnen från datauppsättningen dataset1 , med namnet på datauppsättningen som prefix.
  • Alla kolumner förutom nyckelkolumnen från datauppsättningen dataset2, med namnet på datauppsättningen som prefix.

Stödjer:

  • ScriptEval i laddningsskript.

Detta exempel hittar de flygplatser som ligger närmast punkter i en tabell:

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);
Parametrar för Closest
Parameter Typ Användning Beskrivning
distance real standard: Ingen. Maximalt avstånd från enheten som anges i kostnadsenheten. Objekten som ligger längre ifrån varandra ignoreras.
costUnit sträng standardvärde: meter Bör vara en av meter, yards, kilometer, miles, sekunder, minuter eller timmar. Att använda tidsenheter innebär att restiden används som kostnad och att använda längdenheter innebär att avståndet används. Tidsenheterna är inte tillåtna för avståndstypen Bird (fågelsträcka).
distanceType real standardvärde: Fågelvägen Bestämmer hur avstånd mäts. Följande värden är tillåtna:
  • Bird – mäter direktavstånden (fågelvägen) mellan objekt.
  • Car – mäter längs vägar begränsade till bil. Stöds endast för punktdatauppsättningar.
  • Bike – mäter längs vägar begränsade till cykel. Stöds endast för punktdatauppsättningar.
  • Pedestrian – mäter längs vägar begränsade till gångtrafik. Stöds endast för punktdatauppsättningar.
  • Truck – mäter längs vägar begränsade till lastbilstrafik. Stöds endast för punktdatauppsättningar.
closestCount real standardvärde: 1 Antalet objekt i den andra datauppsättningen som ska associeras med ett objekt i den första datauppsättningen. Ett värde på 1 betyder bara det närmaste, 2 betyder de två närmaste och så vidare.
dataset1 Datauppsättning standardvärde: <första datauppsättning> Objekt som ska kontrolleras för närhet till objekt i dataset2 om det anges, annars till objekt i sig självt. När du kontrollerar närhet mellan objekt i en enda datauppsättning adderas aldrig relationer från ett objekt till sig självt. Stöder strömning av den här datauppsättningen när den skickas från laddningsskriptet och dataset2 definieras, vilket innebär att större tabeller är tillåtna.
dataset2 Datauppsättning standardvärde: <andra datauppsättning om den finns> Objekt att relatera till objekt i dataset1.
precision heltal standardvärde: 6 Ställer in antalet avrundningsdecimaler i koordinater. Standardvärdet är 6 decimaler, vilket motsvarar en precision på ungefär 10 cm. Om du inte vill att koordinater ska avrundas anger du ett negativt värde.

Kluster

Producerar kluster från en punktdatauppsättning baserad på geografisk närhet mellan punkter. Klustergenereringen styrs av parametern avstånd, som definierar hur långt bort en punkt kan vara från det kluster den tillhör. Returnerar en tabell med relationer mellan punkter och kluster. Returnerar också en sammanfogad tabell med namnet Cluster med klustergeometrier. Den innehåller fälten ClusterID, ClusterCenter (punktgeometri) och PointCount. Räkningsfältet innehåller antalet punkter i klustret.

Returnerar följande kolumner:

  • <dataset key column> – nyckelkolumnen från datauppsättningen med indata.
  • ClusterID – ID för klustret som punkten tillhör.
  • Clusters.ClusterPoint – mittpunkt för klustret.
  • Clusters.PointCount – antalet originalpunkter som tillhör klustret.
  • Alla kolumner förutom nyckelkolumnen från indatauppsättningen, med datauppsättningens namn som prefix.

Stödjer:

  • ScriptEval i laddningsskript.

Exemplet innehåller kluster med flygplatser i USA så att flygplatser närmare än 50 km tillhör ett kluster:

MyClusteredAirports: Load * Extension GeoOperations.ScriptEval(' Cluster(distance="50000") DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="us" ');
Parametrar för kluster
Parameter Typ Användning Beskrivning
distance real standard: Ingen. Avståndet mellan en punkt och dess kluster får inte vara längre än avståndet i meter.
dataset Datauppsättning standard: Ingen. Ett dataset med punkter som ska samlas i ett kluster.
precision heltal standardvärde: 6 Ställer in antalet avrundningsdecimaler i koordinater. Standardvärdet är 6 decimaler, vilket motsvarar en precision på ungefär 10 cm. Om du inte vill att koordinater ska avrundas anger du ett negativt värde.

Dissolve

Löser upp och förenklar områden för att bilda större områden baserat på kartläggningen mellan gamla områdesidentiteter (eller geometrier) och nya områdesidentiteter. Detta används vanligtvis för att bygga anpassade områden som byggs upp av mindre väldefinierade områden, till exempel postområden eller förvaltningsområden.

Returnerar följande kolumner:

  • <dissolveField> – fältet som har angetts som dissolveField i indata.
  • DissolvedPolygon – geometrier för de nya upplösta områdena.

Stödjer:

  • ScriptEval i laddningsskript.

Geometridatauppsättningen är valfri. Om det inte tillhandahålls ska geometrier finnas tillgängliga i datauppsättningen med upplösningsdefinitionen.

Observera att överlappningar av polygoner tas bort i alla upplösningar utom Källa.

I det här exemplet skapas två regioner, en som består av CA och AZ och en som består av WA och 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);
Parametrar för Dissolve
Parameter Typ Användning Beskrivning
dissolveField sträng standardvärde: <samma namn som nyckelfältet i dissolveDataset> Namnet på fältet med identiteter i de nya områdena i dissolveDataset.
resolution- sträng standardvärde:Auto Den resulterande datauppsättningen förenklas och graden av förenkling styrs av den här egenskapen. Tillgängliga värden är:
  • auto – Åtgärden beräknar en upplösning baserad på data.
  • autoLow – en upplösning som är lägre än (hälften av) den automatiska upplösningen.
  • autoHigh – en upplösning som är högre än (dubbelt) den automatiska upplösningen.
  • source – Ingen förenkling utförs. Observera att om dissolveDataset innehåller samma gamla områden två gånger i två olika nya områden måste källan användas.
areaDatasetKeyField sträng standardvärde: <nyckelfält i areaDataset> Identiteten på de ursprungliga områdena i areaDataset. Detta används bara om areaDataset har angetts.
dissolveDataset Datauppsättning standardvärde: <första datauppsättning> Definitionen av vilket nytt område varje gammalt område tillhör, det vill säga en kartläggning mellan gammalt område och nya områdesidentiteter. Nyckelfältet måste korrespondera med nycklarna i areaDataset om det anges. Om inget areaDataset tillhandahålls bör geometrier vara tillgängliga i denna datauppsättning.
areaDataset Datauppsättning standardvärde: <andra datauppsättning om den finns> Datauppsättning med områdesgeometrier som ska upplösas. Kan vara inget, vilket betyder att geometrier ska finnas tillgängliga i dissolveDataset. areaDatasetKeyField i denna datauppsättning måste länkas till nyckelfältet i dissolveDataset.
precision heltal standardvärde: 6 Ställer in antalet avrundningsdecimaler i koordinater. Standardvärdet är 6 decimaler, vilket motsvarar en precision på ungefär 10 cm. Om du inte vill att koordinater ska avrundas anger du ett negativt värde.

Intersektioner

Returnerar en tabell som mappar nyckeln i dataset1 till nyckeln i dataset2 för alla objekt som skär varandra. Om båda datauppsättningarna innehåller polygoner, returneras det relativa överlappande området jämfört med områdena i respektive datauppsättning.

Det går att begränsa antalet korsande geometrier i den andra datauppsättningen som ska mappas till varje geometri i den första datauppsättningen genom att specificera intersectsCount. Sedan returneras de mest korsande geometrierna i ordning. Operationen utförs symmetrisk om intersectsCount inte anges.

Returnerar följande kolumner:

  • <dataset1 name>_<dataset2 name>_RelationId – en nyckel som genererats för relationen mellan de två geometrierna.
  • <dataset1 key column> – nyckelkolumnen från dataset1 med indata.
  • <dataset2 key column> – nyckelkolumnen från dataset2 med indata.
  • <dataset1 name>.RelativeOverlap – överlappningen jämfört med polygonen i dataset1. Returneras endast om båda datauppsättningar innehåller polygoner. Det finns en prestandaförlust för att begära detta fält.
  • <dataset2 name>.RelativeOverlap – överlappningen jämfört med polygonen i dataset2. Returneras endast om båda datauppsättningar innehåller polygoner. Det finns en prestandaförlust för att begära detta fält.
  • Alla kolumner förutom nyckelkolumnen från datauppsättningen dataset1, med namnet på datauppsättningen som prefix.
  • Alla kolumner förutom nyckelkolumnen från datauppsättningen dataset2, med namnet på datauppsättningen som prefix.

Stödjer:

  • ScriptEval i laddningsskript.

Det här exemplet beräknar vilka tillstånd vissa linjer skär:

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);
Parametrar för intersektioner
Parameter Typ Användning Beskrivning
dataset1 Datauppsättning standardvärde: <första datauppsättning> En datauppsättning med geometrier som ska testas för om de överlappar geometrierna i den andra datauppsättningen om denna specificerats, eller mellan objekt i datauppsättningen om så inte är fallet. När du kontrollerar skärningspunkten mellan objekt i ett enda dataset, läggs aldrig relationer från ett objekt till sig självt. Stöder strömning av denna datauppsättning när den skickas från laddningsskriptet och när dataset2 definieras, vilket innebär att större tabeller är tillåtna.
dataset2 Datauppsättning standardvärde: <andra datauppsättning om den finns> En datauppsättning med geometrier för test av om de skär genom geometrierna i den andra datauppsättningen. Om det inte anges beräknas skärningspunkten mellan objekt i dataset1.
intersectsCount heltal standardvärde: 0 Om det är större än 0 returneras högst detta antal korsande geometrier i dataset2 per geometri i dataset1. Endast de som skär mest (i största överlappande område eller längd) returneras.
precision heltal standardvärde: 6 Ställer in antalet avrundningsdecimaler i koordinater. Standardvärdet är 6 decimaler, vilket motsvarar en precision på ungefär 10 cm. Om du inte vill att koordinater ska avrundas anger du ett negativt värde.

IpLookup

Returnerar platsinformation och punktgeometrier för IP-adresser i en tabell. Detta är användbart när du analyserar åtkomstdata för webbtjänster. Returnerad tabell innehåller följande fält:
  • Nyckelfält – samma som nyckelfältet för namntabellen.
  • <adresstabell IP-fält> – samma som IP-fältet som slogs upp. Endast tillgängligt om det inte är samma som nyckelfältet.
  • IpPoint – punkten för hittat element.
  • CountryIso2 – landskoden för hittat element.
  • Adm1Code – koden för den första nivåns förvaltningsområde för det hittade elementet. Observera att den här koden inte alltid är kompatibel med koden som returneras av platstjänsten.
  • City – staden med det hittade elementet.
  • Alla kolumner förutom nyckelkolumnen från indatauppsättningen, med datauppsättningens namn som prefix.

Geolokalisering med IP-adress är inte en exakt metod. För många IP-adresser går det att identifiera en ort men för andra kan bara landet hittas.

Det är bäst att bara skicka Ip-kolumnen till åtgärden IpLookup. Exempel som slår upp några IP-adresser:

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});

Det är normalt att samma IP-adress upprepas på flera rader. Då går det snabbare att först filtrera fram unika IP:n som i det här exemplet:

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;

Den här produkten omfattar GeoLite2-data som skapats av MaxMind, tillgängliga från MaxMind.

Parametrar för IpLookup
Parameter Typ Användning Beskrivning
ipField sträng valfritt Fältet med IP-adressen som ska slås upp. Om den inte specificeras används datauppsättningens nyckelfält.
dataset Datauppsättning standard: Ingen. En datauppsättning med IP-adresser som ska slås upp i geokodaren. Stödjer strömning av denna datauppsättning när den skickas från laddningsskriptet, vilket innebär att större tabeller kan användas.
precision heltal standardvärde: 6 Ställer in antalet avrundningsdecimaler i koordinater. Standardvärdet är 6 decimaler, vilket motsvarar en precision på ungefär 10 cm. Om du inte vill att koordinater ska avrundas anger du ett negativt värde.

Ladda

Laddar datauppsättningen utan någon tillämpad åtgärd. Detta gör det möjligt att ladda alla format som GeoOperations stöder. Observera att Simplify kan vara ett bra alternativ till Load ifall geometrierna är detaljerade och visas långsamt.

Returnerar följande kolumner:

  • Alla kolumner från datauppsättningen.

Stödjer:

  • ScriptEval i laddningsskript.

Exempel som laddar postnummer från Sverige:

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

Eftersom WKT stöds som geometriformat för data i INTABLE passar åtgärden Load bra för att konvertera geografiska geometrier som laddats från en databas till geometriformatet Sense så att det kan visas. Följande exempel visar hur du omvandlar WKT-data, i det här fallet från tabellen 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);
Parametrar för Load
Parameter Typ Användning Beskrivning
dataset Datauppsättning standardvärde: <första datauppsättning> Datauppsättning som ska laddas. Stödjer strömning av denna datauppsättning när den skickas från laddningsskriptet, vilket innebär att större tabeller kan användas.
precision heltal standardvärde: 6 Ställer in antalet avrundningsdecimaler i koordinater. Standardvärdet är 6 decimaler, vilket motsvarar en precision på ungefär 10 cm. Om du inte vill att koordinater ska avrundas anger du ett negativt värde.

PointToAddressLookup

Returnerar närmaste adress för punkter i listan, kallas även omvänd geokodning. Den här operationen kräver en särskild licens. Punkter som ligger nära gator får adresser på gatunivå, annars returneras träffar på postområde eller ort. Inga data returneras för punkter som ligger för långt bort.

Returnerar följande kolumner:

  • <dataset key column> – nyckelkolumnen från datauppsättningen med indata.
  • Adress – hittad adress, formaterad enligt landets adresstandard.
  • Geometry – punkten för hittat element.
  • HouseNumber – husnummer för hittat element.
  • Street – gatan för hittat element.
  • PostalCode – postnumret för hittat element.
  • City – namnet på förvaltningsenheten på ortnivå för hittat element.
  • Adm1 – namnet eller förkortning av namnet på första nivåns förvaltningsenhet (delstat) för hittat element.
  • CountryIso2 – landskoden för hittat element.
  • Distance – avstånd i meter till adressen som hittades.
  • Alla kolumner förutom nyckelkolumnen från datauppsättningen, med datauppsättningens namn som prefix.

Observera att returnerade fält kan vara tomma om ej tillämpligt eller när inga data är tillgängliga.

Exempel som hämtar adresser för några punkter:

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);
Parametrar för PointToAddressLookup
Parameter Typ Användning Beskrivning
language sträng standardvärde: En språkkod med två bokstäver för det föredragna språket för adressen i svaret. Om inte adressen är tillgänglig på önskat språk returneras den med platsens standardspråk.
dataset Datauppsättning standard: Ingen. En datauppsättning med punkter som ska slås upp i geokodaren. Stödjer strömning av denna datauppsättning när den skickas från laddningsskriptet, vilket innebär att större tabeller kan användas.
precision heltal standardvärde: 6 Ställer in antalet avrundningsdecimaler i koordinater. Standardvärdet är 6 decimaler, vilket motsvarar en precision på ungefär 10 cm. Om du inte vill att koordinater ska avrundas anger du ett negativt värde.

Routes

Beräknar rutter, inklusive längd och varaktighet, mellan två platser i en tabell.

Observera att startpunkten är geometrikolumnen i datauppsättningen. Destinationskolumnen specificeras med operationsparametrar, eftersom datauppsättningar bara har en geometrikolumn.

Om du använder bird som färdsätt genereras stora cirkelformade bågar mellan startpunkter och destinationer.

Returnerar följande kolumner:

  • <dataset key column> – nyckelkolumnen från datauppsättningen med indata.
  • Distance – ruttavståndet i meter.
  • Duration – den uppskattade restiden för rutten i sekunder.
  • Status – returnerad status är antingen "ok" eller "failed:" åtföljt av ett felmeddelande.
  • LowResLine – en lågupplöst version av ruttlinjen.
  • Alla kolumner förutom nyckelkolumnen från indatauppsättningen, med datauppsättningens namn som prefix.

Stödjer:

  • ScriptEval i laddningsskript.
  • ScriptEvalStr i diagramskript för att hämta rutten.
  • ScriptEval i diagramskript för att hämta avståndet eller varaktigheten.

Det här är ett exempel som beräknar rutter mellan punkter i en datauppsättning:

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

Det här är ett exempel som beräknar rutter direkt i ett linjeskikt. Operationen anropas för urvalet varje gång urvalet ändras. Normalt ska det finnas ett beräkningsvillkor som är sant om bara några få punkter väljs (annars är det bättre att beräkna rutterna i laddningsskriptet). Följande ska infogas i laddningsskriptet för att ladda data. Exempel:

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

Använd följande dimension i linjeskiktet:

LocationDbId

Använd ett beräkningsvillkor i linjeskiktet:

Count(LocationDbId)<10

Ange följande, i egenskapen Plats, som ska vara inställd på Linjegeometri, för att beräkna rutterna från en fast position till de valda punkterna:

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

Parametrar för Routes
Parameter Typ Användning Beskrivning
dataset Datauppsättning standard: Ingen. En datauppsättning med ursprung och destinationer för rutter som ska beräknas. Startpunkterna ska finnas med i datauppsättningens geometri. Stödjer strömning av denna datauppsättning när den skickas från laddningsskriptet, vilket innebär att större tabeller kan användas.
kriterier sträng standardvärde: snabbast Välj om den snabbaste eller kortaste rutten ska beräknas.
transportation sträng standardvärde: bil Färdsättet, som är något av följande: bil, lastbil, cykel, fotgängare eller fågelvägen (som flyger i 10 m/s).
destField sträng standard: Ingen. Det fält i datauppsättningen som specificerar destinationen. Observera att startpunkten är geometrifältet som specificerats i datauppsättningen.
geometryType sträng standardvärde:POINT Geometrityp i destField. Följande värden accepteras: Point, NamedPoint och LatLon. Om namngivna punkter används, slås geometrin upp i platstjänsten och en kolumn läggs till för geometrin.
suffix sträng standard: Ingen. För avancerade användare. Den specificerade strängen läggs till efter alla ID:n. Det här är ett praktiskt sätt att specificera mer information för serverbaserade platstjänster, som landskod eller typ. Alternativet är att lägga till extra data när tabellen laddas till Qlik. Med följande suffix anges alla element som orter i Sverige:
,SE:city
Se Guide för platstjänsten för mer information om den syntax som ska användas.
precision heltal standardvärde: 6 Ställer in antalet avrundningsdecimaler i koordinater. Standardvärdet är 6 decimaler, vilket motsvarar en precision på ungefär 10 cm. Om du inte vill att koordinater ska avrundas anger du ett negativt värde.

Simplify

Förenklar linje- och områdesgeometrier i en datauppsättning. Det är ofta användbart att ladda geografiska data med åtgärden Simplify istället för Load för att få effektivare geometrier som kan visas snabbare.

Förenklingsgraden beräknas automatiskt baserat på area, antal objekt och objektstorlek. Det är sedan möjligt att justera det till en högre eller lägre upplösning med parametern upplösning.

Områdesförenkling görs med en algoritm som hanterar topologier och kan ta bort luckor och ansluta öar.

Linjeförenkling görs med en algoritm för minskning av brytpunkter.

Observera att överlappningar av polygoner tas bort. Det kommer inte att finnas några överlappande polygoner i utdata.

Returnerar följande kolumner:

  • <dataset key column> – nyckelkolumnen från indata dataset1.
  • Simplified_<geometry column name> – förenklade versioner av de ursprungliga geometrierna.
  • Alla kolumner förutom nyckelkolumnen från datauppsättningen, med datauppsättningens namn som prefix.

Stödjer:

  • ScriptEval i laddningsskript.

Exempel som laddar förenklade versioner av amerikanska stater:

Load * Extension GeoOperations.ScriptEval(' SELECT LocationDbId, Simplified_LocationPolygon FROM Simplify() DATASOURCE states LOCATIONSERVICE type="State", country="us" ');
Parametrar för Simplify
Parameter Typ Användning Beskrivning
resolution- sträng standardvärde:Auto Den resulterande datauppsättningen förenklas och graden av förenkling styrs av den här egenskapen. Tillgängliga värden är:
  • Auto – Åtgärden beräknar en upplösning baserad på data.
  • AutoLow – en upplösning som är lägre än (hälften av) den automatiska upplösningen.
  • AutoHigh – en upplösning som är högre än (dubbelt) den automatiska upplösningen.
dataset Datauppsättning standardvärde:<första datauppsättning> Datauppsättningen med geometrier som ska förenklas.
precision heltal standardvärde: 6 Ställer in antalet avrundningsdecimaler i koordinater. Standardvärdet är 6 decimaler, vilket motsvarar en precision på ungefär 10 cm. Om du inte vill att koordinater ska avrundas anger du ett negativt värde.

TravelAreas

Beräknar restider inom områden. Alla platser inom det returnerade området kan nås inom en viss tid, eller ligger inom ett visst avstånd längs vägar. Returnerar en tabell med id, reseområdets geometri, mittpunkt, kostnad, kostnadsenhet och status (OK eller failed).

Om du väljer ”bird” som färdsätt, genereras geografiskt korrekta cirklar runt startpunkten.

Returnerar följande kolumner:

  • <dataset key column> – nyckelkolumnen från datauppsättningen med indata.
  • TravelArea – polygongeometrin som definierar reseområdet.
  • Cost – kostnaden som den har angetts i costValue eller costField.
  • CostUnit – kostnadsenheten som den har angetts i costUnit.
  • Status – returnerad status är antingen "OK" eller "failed:" åtföljt av ett felmeddelande.
  • Alla kolumner förutom nyckelkolumnen från indatauppsättningen, med datauppsättningens namn som prefix.

Stödjer:

  • ScriptEval i laddningsskript.
  • ScriptEvalStr i diagramskript för att hämta reseområdets geometri.
  • ScriptEval i diagramskript för att hämta kostnaden.

Exemplet med laddningsskriptet genererar reseområden på 10 minuter i Miami och Orlando från koordinaterna:

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

Exemplet med laddningsskriptet genererar reseområden på 10 minuter i Miami och Orlando med namngivna punkter:

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});

Det här är ett exempel som beräknar Reseområden kring punkter direkt i Ytskikt. Operationen anropas för urvalet varje gång urvalet ändras. Följande ska infogas i laddningsskriptet för att ladda data som används i exemplet:

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

Använd följande dimension i Ytskikt:

LocationDbId

Använd ett beräkningsvillkor i Ytskikt:

Count(LocationDbId)<10

Ange det här i egenskapen Location:

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

Parametrar för TravelAreas
Parameter Typ Användning Beskrivning
dataset Datauppsättning standardvärde: <första datauppsättning> En datauppsättning med ursprung och beräkning av kostnader för reseområden som tillval. Stödjer strömning av denna datauppsättning när den skickas från laddningsskriptet, vilket innebär att större tabeller kan användas.
costValue tal standard: Ingen. Kostnaden vid det returnerade områdets gräns. Kostnaden kan vara en längd eller en tid. (Se costUnit nedan.) Om du vill använda individuella kostnader för varje område kan du specificera costField istället.
costField sträng standard: Ingen. Ett fält i datauppsättningen som specificerar kostnaden. Detta används bara om costValue är tomt.
costUnit sträng standardvärde: sekunder Ska vara något av följande: seconds, minutes, hours, meters, yards, kilometers eller miles. När en tidsenhet används beräknas området som kan nås inom den tidsperioden, och när en längdenhet används beräknas området där reseavståndet är kortare än specificerat.
transportation sträng standardvärde: bil Färdsättet, som är något av följande: car, truck, bike, pedestrian eller bird (som flyger 10 m/s).
precision heltal standardvärde: 6 Ställer in antalet avrundningsdecimaler i koordinater. Standardvärdet är 6 decimaler, vilket motsvarar en precision på ungefär 10 cm. Om du inte vill att koordinater ska avrundas anger du ett negativt värde.

Within

Returnerar relationerna mellan två datauppsättningar, där en geometri i en datauppsättning (enclosed) ligger helt inom området i den andra datauppsättningen (enclosing). Returnerar en tabell som mappar nyckeln inom omslutningen till nyckeln inom omslutningen för alla relationer som hittas.

Används vanligen för att hitta områdena som data befinner sig i, till exempel för att testa i vilket förvaltningsområde en GPS-position finns. Det här är ett slags omvänd geokodning.

Returnerar följande kolumner:

  • <enclosed name>_<enclosing name>_RelationId – en nyckel som genererats för relationen mellan de två geometrierna.
  • <enclosed key column> – nyckelkolumnen från dataset1 med indata.
  • <enclosing key column> – nyckelkolumnen från dataset2 med indata.
  • Alla kolumner förutom nyckelkolumnen från den omslutna datauppsättningen, med datauppsättningens namn som prefix.
  • Alla kolumner förutom nyckelkolumnen från den omslutna datauppsättningen, med datauppsättningens namn som prefix.

Stödjer:

  • ScriptEval i laddningsskript.

För att kunna hantera felaktigheter i data kan det ibland vara bättre att använda Closest istället för Within. Om du till exempel vill koppla punktdata i kustområden till förvaltningsområden, kan små felaktigheter göra att punkter hamnar något utanför områdena.

Det här är ett exempel på ett laddningsskript som beräknar vilka punkter som ligger inom vilka delstater:

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);
Parametrar för Within
Parameter Typ Användning Beskrivning
enclosed Datauppsättning standardvärde: <första datauppsättning> En datauppsättning med geometrier som ska testas för vilka områden de omsluts av. Stödjer strömning av denna datauppsättning när den skickas från laddningsskriptet, vilket innebär att större tabeller kan användas.
enclosing Datauppsättning standardvärde: <andra datauppsättning> En datauppsättning med områdesgeometrier som ska testas för vilka geometrier de omsluter. Stödjer strömning av denna datauppsättning när den skickas från laddningsskriptet, vilket innebär att större tabeller kan användas.
precision heltal standardvärde: 6 Ställer in antalet avrundningsdecimaler i koordinater. Standardvärdet är 6 decimaler, vilket motsvarar en precision på ungefär 10 cm. Om du inte vill att koordinater ska avrundas anger du ett negativt värde.
 

Var den här sidan till hjälp för dig?

Om du hittar några fel på denna sida eller i innehållet – ett stavfel, ett steg som saknas eller ett tekniskt fel – berätta för oss så att vi kan blir bättre!