Operation | Qlik CloudHjälp
Gå till huvudinnehåll Gå till ytterligare innehåll

Operation

AddressPointLookup

Returnerar punktgeometrier för adresser i en tabell, det vill säga geokodning. Ange antingen en adresssträng i egenskapen Search Text eller strukturerade delar i motsvarande egenskaper, såsom Country, Street etc. Kombinationer är också tillåtna. Denna operation kräver en särskild licens. Adresser som av någon anledning inte kunde hittas returneras inte i resultatet.

Den funktionalitet som erbjuds av Qlik Geocoding (via AddressPointLookup och PointToAddressLookup) skiljer sig från andra funktioner för uppslagning av plats. Qlik Geocoding tillåter uppslagningar på adressnivå, medan vanliga platsuppslagningar endast kan vara så exakta som på postnummernivå.

När du kommer igång med Qlik Geocoding, använd mallen som refereras till i Konfigurera Qlik Geocoding (endast på engelska).

Anteckning om information För bästa resultat, prioritera specifika data och utelämna breda data när det är möjligt. Till exempel, om du har både ett postnummer och en postort, och du litar på att postnumret är korrekt, är det bäst att inte ange postorten.

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

Anteckning om information Du måste ha användarrollbehörigheten Use : för att använda AddressPointLookup.
Anteckning om information För att geokoda engelska eller pinyin-adresser i Kina måste parametern Country vara inställd på "CHN".

Returnerar följande kolumner:

  • <dataset key column> - Nyckelkolumnen från indata-datasetet.
  • Address - Den hittade adressen, formaterad enligt landets adress-standarder.
  • Geometry - Punkten för det hittade objektet.
  • HouseNumber - Husnumret för det hittade objektet.
  • Street - Gatan för det hittade objektet.
  • PostalCode - Postnumret för det hittade objektet.
  • City - Namnet på den administrativa indelningen på stadsnivå för det hittade objektet.
  • Adm1 - Namnet eller det förkortade namnet på den administrativa indelningen av första ordningen (delstat) för det hittade objektet.
  • CountryIso2 - Landskoden för det hittade objektet.
  • Match - Ett värde mellan 0 och 1 som visar hur bra matchningen var. Värdet 1 innebär en perfekt matchning.
  • Alla kolumner utom nyckelkolumnen från dataset, med datasetets namn som prefix.

De returnerade fälten kan vara tomma där de inte är tillämpliga eller där data inte är tillgängliga.

Stöder:

  • ScriptEval i laddningsskript.

Exempel som geokodar några svenska adresser där varje objekt finns i ett 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 i fritextformat:

[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 string valfri En textsträng att söka efter. Kan vara adresser som: "1600 Pennsylvania Ave, Washington DC, USA" eller ofullständiga adresser som kombineras med data i andra fält, såsom "1117 Washington Ave" med City inställt på "Philadelphia" och Country inställt på "USA".
searchTextField string valfri Om searchText inte anges kan denna parameter användas för att ange ett fält där informationen ska hämtas från.
country string valfri En sträng med trebokstaviga ISO-koder. Flera länder kan anges, separerade med kommatecken: "SWE,NOR,FIN". För att specifikt geokoda engelska eller pinyin-adresser i Kina måste denna parameter vara inställd på "CHN".
countryField string valfri Om country inte anges kan denna parameter användas för att ange ett fält som innehåller landets namn eller två- eller trebokstaviga ISO-koder. Observera att till skillnad från de andra parametrarna är det förväntade formatet för de data som anges av country och countryField inte identiskt. Parametern country tillåter flera länder, men endast i trebokstavigt ISO-format, medan countryField tillåter olika landsformat.
state string valfri Delstatsnamn eller kod. För de flesta länder är delstaten inte en del av adressen.
stateField string valfri Om state inte anges kan denna parameter användas för att ange ett fält där informationen ska hämtas från.
city string valfri Stadsnamn, kommun eller postort.
cityField string valfri Om city inte anges kan denna parameter användas för att ange ett fält där informationen ska hämtas från.
postalCode string valfri Postnummer.
postalCodeField string valfri Om postalCode inte anges kan denna parameter användas för att ange ett fält där informationen ska hämtas från.
street string valfri Gatunamn. Istället för att ange gata och husnummer i separata parametrar eller fält kan båda anges tillsammans, separerade med ett mellanslag.
streetField string valfri Om street inte anges kan denna parameter användas för att ange ett fält där informationen ska hämtas från.
houseNumber string valfri Husnummer.
houseNumberField string valfri Om houseNumber inte anges kan denna parameter användas för att ange ett fält där informationen ska hämtas från.
matchThreshold real standard: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 string standard: Ingen. En tvåbokstavig språkkod för det föredragna språket för adressen i svaret. Om adressen inte är tillgänglig på det begärda språket returneras den på ett standardspråk för platsen.
dataset Dataset standard: Ingen. Ett dataset med adresser som kommer att slås upp i geokodaren. Stöder strömning av detta dataset när det skickas från laddningsskriptet, vilket innebär att större tabeller tillåts.
precision integer standard:6 Ställer in antalet decimaler att avrunda till i koordinater. Standardvärdet är 6 decimaler, vilket ger en precision på cirka 10 cm. Om du inte vill att koordinaterna ska avrundas, ställ in värdet på ett negativt tal.

Binning

Genererar rektangulära eller hexagonala fack (bins) för ett punktdataset. Detta är ett sätt att aggregera punktdata så att en översikt av data kan visas effektivt.

Returnerar följande kolumner:

  • <dataset key column> - Nyckelkolumnen från indata-datasetet.
  • BinId - Identitet för facket.
  • BinTable.BinPolygon - Polygonen för facket.
  • BinTable.CenterPoint - Punkten i mitten av facket.
  • Alla kolumner utom nyckelkolumnen från dataset, med datasetets namn som prefix.

Stöder:

  • ScriptEval i laddningsskript.

Exempel som laddar hexagonala fack 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
type string standard:rectangular Definierar om rektangulära eller hexagonala fack ska genereras.
gridSize real standard: Ingen. Höjden på ett enskilt fack i grader. En grad är ungefär 10000 m.
gridWidthHeightRatio real standard:1.5 Bredd-höjd-förhållandet för fack. Kvadratiska fack är ofta optimala, men det varierar beroende på latitud. Formeln för det optimala bredd-höjd-fö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 fackindelade data i den Anpassade projektionen än i Mercator-projektionen.
dataset Dataset standard: Ingen. Datasetet med punktgeometrier att generera fack för. Stöder strömning av detta dataset när det skickas från laddningsskriptet, vilket innebär att större tabeller tillåts.
precision integer standard:6 Ställer in antalet decimaler att avrunda till i koordinater. Standardvärdet är 6 decimaler, vilket ger en precision på cirka 10 cm. Om du inte vill att koordinaterna ska avrundas, ställ in värdet på ett negativt tal.

Closest

Returnerar relationer och avstånd mellan objekt i ett dataset och de närmaste objekten i ett annat, om något är närmare än det maximala avståndet. Kostnaden kan också beräknas längs vägar, och i så fall valfritt använda restid. Denna operation ä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 genererad för relationen mellan de två geometrierna.
  • <dataset1 key column> - Nyckelkolumnen från indata-dataset1.
  • <dataset2 key column> - Nyckelkolumnen från indata-dataset2.
  • Distance - Avståndet i den enhet som anges i costUnit.
  • Status - Den returnerade statusen är antingen "ok" eller "failed:" följt av ett felmeddelande.
  • LowResLine - En lågupplöst version av ruttlinjen, endast tillgänglig för avståndstyper som inte är bird.
  • Alla kolumner utom nyckelkolumnen från indata-datasetet dataset1, med datasetets namn som prefix.
  • Alla kolumner utom nyckelkolumnen från indata-datasetet dataset2, med datasetets namn som prefix.

Stöder:

  • ScriptEval i laddningsskript.

Det här exemplet hittar de närmaste flygplatserna till 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 den enhet som anges i Cost unit. Objekt som ligger längre ifrån varandra än detta ignoreras.
costUnit string standard:meters Ska vara en av meters, yards, kilometers, miles, seconds, minutes eller hours. Användning av tidsenheter innebär att restiden används som kostnad och längdenheter att avståndet används. Tidsenheterna är inte tillåtna för avståndstypen Bird.
distanceType real standard:Bird Avgör hur avstånd mäts. Följande värden är tillåtna:
  • Bird - mät direkta avstånd (fågelvägen) mellan objekt.
  • Car - mät längs vägar med bilrestriktioner. Stöds endast för punktdataset.
  • Bike - mät längs vägar med cykelrestriktioner. Stöds endast för punktdataset.
  • Pedestrian - mät längs vägar med fotgängarrestriktioner. Stöds endast för punktdataset.
  • Truck - mät längs vägar med lastbilsrestriktioner. Stöds endast för punktdataset.
closestCount real standard:1 Antal objekt i det andra datasetet att associera med ett objekt i det första datasetet. Värdet 1 betyder endast det närmaste, 2 betyder de två närmaste, och så vidare.
dataset1 Dataset standard:<första datasetet> Objekt att kontrollera närhet till objekt i dataset2 om det anges, annars till objekt i sig självt. Vid kontroll av närhet mellan objekt i ett enda dataset läggs relationer aldrig till från ett objekt till sig självt. Stöder strömning av detta dataset när det skickas från laddningsskriptet och dataset2 är definierat, vilket innebär att större tabeller tillåts.
dataset2 Dataset standard:<andra datasetet om något> Objekt att relatera till objekt i dataset1.
precision integer standard:6 Ställer in antalet decimaler att avrunda till i koordinater. Standardvärdet är 6 decimaler, vilket ger en precision på cirka 10 cm. Om du inte vill att koordinaterna ska avrundas, ställ in värdet på ett negativt tal.

Cluster

Producerar kluster från ett punktdataset baserat på geografisk närhet mellan punkter. Klustergenereringen styrs av parametern distance, som definierar hur långt bort en punkt får vara från det kluster den tillhör. Returnerar en tabell med relationer mellan punkter och kluster. Returnerar också en inkopplad tabell med namnet Clusters med klustergeometrier. Den innehåller fälten ClusterID, ClusterCenter (punktgeometri) och PointCount. Antalsfältet innehåller antalet punkter i klustret.

Returnerar följande kolumner:

  • <dataset key column> - Nyckelkolumnen från indata-datasetet.
  • ClusterID - Id för det kluster punkten tillhör.
  • Clusters.ClusterPoint - Mittpunkt för klustret.
  • Clusters.PointCount - Antal ursprungliga punkter som tillhör klustret.
  • Alla kolumner utom nyckelkolumnen från indata-datasetet, med datasetets namn som prefix.

Stöder:

  • ScriptEval i laddningsskript.

Det här exemplet klustrar 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 Cluster
Parameter Typ Användning Beskrivning
distance real standard: Ingen. Avståndet mellan en punkt och dess kluster kan inte vara längre än detta avstånd i meter.
dataset Dataset standard: Ingen. Ett dataset med punkter att klustra.
precision integer standard:6 Ställer in antalet decimaler att avrunda till i koordinater. Standardvärdet är 6 decimaler, vilket ger en precision på cirka 10 cm. Om du inte vill att koordinaterna ska avrundas, ställ in värdet på ett negativt tal.

Dissolve

Löser upp och förenklar områden för att bilda större områden baserat på mappningen mellan gamla områdesidentiteter (eller geometrier) och nya områdesidentiteter. Detta används vanligtvis för att bygga anpassade områden som är uppbyggda av mindre väldefinierade områden, såsom postnummerområden eller administrativa områden.

Returnerar följande kolumner:

  • <dissolveField> - Fältet som anges som dissolveField i indata.
  • DissolvedPolygon - Geometrierna för de nya upplösta områdena.

Stöder:

  • ScriptEval i laddningsskript.

Geometridatasetet är valfritt. Om det inte tillhandahålls förväntas geometrier vara tillgängliga i datasetet för upplösningsdefinitionen.

Observera att överlappningar av polygoner tas bort i alla upplösningar utom Source.

Det här exemplet skapar 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 string standard:<samma namn som nyckelfältet i dissolveDataset> Namnet på fältet med identiteter för de nya områdena i dissolveDataset.
resolution string standard:Auto Det resulterande datasetet förenklas och graden av förenkling styrs av denna egenskap. Tillgängliga värden är:
  • auto - Operationen beräknar en upplösning baserat på data.
  • autolow - En upplösning som är lägre än (hälften av) Auto-upplösningen.
  • autohigh - En upplösning som är högre än (dubbelt så hög som) Auto-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 source användas.
areaDatasetKeyField string standard:<nyckelfält i areaDataset> Identiteterna för de ursprungliga områdena i areaDataset. Detta används endast om areaDataset anges.
dissolveDataset Dataset standard:<första datasetet> Definitionen av vilket nytt område varje gammalt område tillhör, det vill säga en mappning mellan gamla och nya områdesidentiteter. Nyckelfältet bör mappa till nycklarna i areaDataset om det anges. Om inget areaDataset tillhandahålls bör geometrierna vara tillgängliga i detta dataset.
areaDataset Dataset standard:<andra datasetet om något> Datasetet med områdesgeometrier att lösa upp. Kan vara inget, vilket innebär att geometrierna bör vara tillgängliga i dissolveDataset. areaDatasetKeyField i detta dataset måste vara länkat till nyckelfältet i dissolveDataset.
precision integer standard:6 Ställer in antalet decimaler att avrunda till i koordinater. Standardvärdet är 6 decimaler, vilket ger en precision på cirka 10 cm. Om du inte vill att koordinaterna ska avrundas, ställ in värdet på ett negativt tal.

Intersects

Returnerar en tabell som mappar mellan nyckeln i dataset1 och nyckeln i dataset2 för alla objekt som skär varandra. Om båda dataseten innehåller polygoner returneras den relativa överlappningsarean jämfört med areorna i respektive dataset.

Det är möjligt att begränsa antalet skärande geometrier i det andra datasetet som ska mappas till varje geometri i det första datasetet genom att ange intersectsCount. Då returneras de mest skärande geometrierna i ordning. Operationen är symmetrisk om intersectsCount inte anges.

Returnerar följande kolumner:

  • <dataset1 name>_<dataset2 name>_RelationId - En nyckel genererad för relationen mellan de två geometrierna.
  • <dataset1 key column> - Nyckelkolumnen från indata-dataset1.
  • <dataset2 key column> - Nyckelkolumnen från indata-dataset2.
  • <dataset1 name>.RelativeOverlap - Överlappningen jämfört med polygonen i dataset1. Returneras endast om båda dataseten innehåller polygoner. Det finns en prestandaförlust vid begäran av detta fält.
  • <dataset2 name>.RelativeOverlap - Överlappningen jämfört med polygonen i dataset2. Returneras endast om båda dataseten innehåller polygoner. Det finns en prestandaförlust vid begäran av detta fält.
  • Alla kolumner utom nyckelkolumnen från indata-datasetet dataset1, med datasetets namn som prefix.
  • Alla kolumner utom nyckelkolumnen från indata-datasetet dataset2, med datasetets namn som prefix.

Stöder:

  • ScriptEval i laddningsskript.

Det här exemplet beräknar vilka delstater som 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 Intersects
Parameter Typ Användning Beskrivning
dataset1 Dataset standard:<första datasetet> Ett dataset med geometrier att testa för vilka som skär geometrierna i det andra datasetet om det anges, eller mellan objekt i detta dataset om inte. Vid kontroll av skärning mellan objekt i ett enda dataset läggs relationer aldrig till från ett objekt till sig självt. Stöder strömning av detta dataset när det skickas från laddningsskriptet och när dataset2 är definierat, vilket innebär att större tabeller tillåts.
dataset2 Dataset standard:<andra datasetet om något> Ett dataset med geometrier att testa för vilka som skär geometrierna i det andra datasetet. Om det inte anges beräknas skärningen mellan objekt i dataset1.
intersectsCount integer standard:0 Om större än 0 returneras högst detta antal skärande geometrier i dataset2 per dataset1-geometri. Endast de som skär mest (störst överlappande area eller längd) returneras.
precision integer standard:6 Ställer in antalet decimaler att avrunda till i koordinater. Standardvärdet är 6 decimaler, vilket ger en precision på cirka 10 cm. Om du inte vill att koordinaterna ska avrundas, ställ in värdet på ett negativt tal.

IpLookup

Returnerar platsinformation och punktgeometrier för IP-adresser i en tabell. Detta är användbart när du analyserar åtkomstdata till webbtjänster. Den returnerade tabellen innehåller följande fält:
  • Nyckelfält - Samma som nyckelfältet för namntabellen.
  • <Address Table Ip Field> - Samma som IP-fältet som slogs upp. Endast tillgängligt om det inte är samma som nyckelfältet.
  • IpPoint - Punkten för det hittade objektet.
  • CountryIso2 - Landskoden för det hittade objektet.
  • Adm1Code - Koden för det administrativa området av första ordningen för det hittade objektet. Observera att denna kod inte alltid är kompatibel med koden som returneras av platstjänsten.
  • City - Staden för det hittade objektet.
  • Alla kolumner utom nyckelkolumnen från indata-datasetet, med datasetets namn som prefix.

IP-geolokalisering är i sig oprecis. För många IP-adresser är det möjligt att peka ut en stad, men för andra kan endast land fastställas.

Bästa praxis är att endast skicka Ip-kolumnen till operationen 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 vanligt att samma IP upprepas på många rader. Det förbättrar då prestandan att först filtrera ut endast de unika IP-adresserna 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;

Denna produkt inkluderar GeoLite2-data skapad av MaxMind, tillgänglig från MaxMind.

Parametrar för IpLookup
Parameter Typ Användning Beskrivning
ipField string valfri Fältet med IP-adressen att slå upp. Använder nyckelfältet i datasetet om det inte anges.
dataset Dataset standard: Ingen. Ett dataset med IP-adresser som kommer att slås upp i geokodaren. Stöder strömning av detta dataset när det skickas från laddningsskriptet, vilket innebär att större tabeller tillåts.
precision integer standard:6 Ställer in antalet decimaler att avrunda till i koordinater. Standardvärdet är 6 decimaler, vilket ger en precision på cirka 10 cm. Om du inte vill att koordinaterna ska avrundas, ställ in värdet på ett negativt tal.

Load

Laddar datasetet utan att någon operation tillämpas. Detta gör det möjligt att ladda alla format som GeoOperations stöder. Observera att Simplify kan vara ett bra alternativ till Load om geometrier är detaljerade och långsamma att visa.

Returnerar följande kolumner:

  • Alla kolumner från dataset.

Stöder:

  • 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 är operationen Load utmärkt för att konvertera geografiska geometrier som laddats från en databas till Sense-geometriformatet så att det kan visas. Följande exempel visar hur man konverterar 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 Dataset standard:<första datasetet> Dataset att ladda. Stöder strömning av detta dataset när det skickas från laddningsskriptet, vilket innebär att större tabeller tillåts.
precision integer standard:6 Ställer in antalet decimaler att avrunda till i koordinater. Standardvärdet är 6 decimaler, vilket ger en precision på cirka 10 cm. Om du inte vill att koordinaterna ska avrundas, ställ in värdet på ett negativt tal.

PointToAddressLookup

Returnerar den närmaste adressen för punkter i listan, även känt som omvänd geokodning. Denna operation kräver en särskild licens. Punkter som ligger nära gator får adresser på gatunivå, annars faller den tillbaka på att returnera träffar på postområdes- eller stadsnivå. För punkter som är för långt borta returneras inga data.

Anteckning om information Du måste ha användarrollbehörigheten Use : för att använda PointToAddressLookup.

Returnerar följande kolumner:

  • <dataset key column> - Nyckelkolumnen från indata-datasetet.
  • Address - Den hittade adressen, formaterad enligt landets adress-standarder.
  • Geometry - Punkten för det hittade objektet.
  • HouseNumber - Husnumret för det hittade objektet.
  • Street - Gatan för det hittade objektet.
  • PostalCode - Postnumret för det hittade objektet.
  • City - Namnet på den administrativa indelningen på stadsnivå för det hittade objektet.
  • Adm1 - Namnet eller det förkortade namnet på den administrativa indelningen av första ordningen (delstat) för det hittade objektet.
  • CountryIso2 - Landskoden för det hittade objektet.
  • Distance - Avstånd i meter till den hittade adressen.
  • Alla kolumner utom nyckelkolumnen från dataset, med datasetets namn som prefix.

Observera att de returnerade fälten kan vara tomma där de inte är tillämpliga eller där data inte är tillgängliga.

Exempel som hämtar adresserna 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 string standard: En tvåbokstavig språkkod för det föredragna språket för adressen i svaret. Om adressen inte är tillgänglig på det begärda språket returneras den på ett standardspråk för platsen.
dataset Dataset standard: Ingen. Ett dataset med punkter som kommer att slås upp i geokodaren. Stöder strömning av detta dataset när det skickas från laddningsskriptet, vilket innebär att större tabeller tillåts.
precision integer standard:6 Ställer in antalet decimaler att avrunda till i koordinater. Standardvärdet är 6 decimaler, vilket ger en precision på cirka 10 cm. Om du inte vill att koordinaterna ska avrundas, ställ in värdet på ett negativt tal.

Routes

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

Observera att ursprunget är geometrikolumnen i datasetet. Destinationskolumnen anges i operationsparametrarna eftersom dataset endast känner till en geometrikolumn.

Om du använder bird som transporttyp genereras storcirkelbågar mellan ursprung och destinationer.

Returnerar följande kolumner:

  • <dataset key column> - Nyckelkolumnen från indata-datasetet.
  • Distance - Ruttens avstånd i meter.
  • Duration - Den uppskattade restiden för rutten i sekunder.
  • Status - Den returnerade statusen är antingen "ok" eller "failed:" följt av ett felmeddelande.
  • LowResLine - En lågupplöst version av ruttlinjen.
  • Alla kolumner utom nyckelkolumnen från indata-datasetet, med datasetets namn som prefix.

Stöder:

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

Detta är ett exempel som beräknar rutter mellan punkter i ett dataset:

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

Detta är ett exempel som beräknar rutter direkt i ett linjelager. Operationen anropas för urvalet varje gång urvalet ändras. Normalt bör det finnas ett beräkningsvillkor som är sant om endast ett fåtal punkter är valda (annars är det bättre att beräkna rutterna i laddningsskriptet). Detta bör läggas i laddningsskriptet för att ladda data. Till exempel:

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

Använd följande dimension i linjelagret:

LocationDbId

Använd ett beräkningsvillkor i linjelagret:

Count(LocationDbId)<10

I egenskapen Location, som bör vara inställd på Line geometry, lägg in detta 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 Dataset standard: Ingen. Ett dataset med ursprung och destinationer för de rutter som ska beräknas. Ursprungen bör finnas i datasetets geometri. Stöder strömning av detta dataset när det skickas från laddningsskriptet, vilket innebär att större tabeller tillåts.
criteria string standard:fastest Välj mellan att beräkna den fastest (snabbaste) eller shortest (kortaste) rutten.
transportation string standard:car Transportmedlet, ett av car, truck, bike, pedestrian eller bird (som flyger i 10 m/s).
destField string standard: Ingen. Fältet i datasetet som anger destinationen. Observera att ursprunget är det geometrifält som anges i datasetet.
geometryType string standard:POINT Typ av geometri i destField. Tillåtna värden är Point, NamedPoint och LatLon. Vid namngivna punkter slås geometrin upp i platstjänsten och en kolumn för geometrin läggs till.
suffix string standard: Ingen. För avancerade användare. Den angivna strängen läggs till i alla ID:n. Detta är ett bekvämt sätt att ange mer information till serverbaserade platstjänster, såsom landskod eller typ. Alternativet är att lägga till extra data när tabellen laddas in i Qlik. Med följande suffix anges alla objekt som städer i Sverige:
,SE:city
Se Location Service Guide för mer information om vilken syntax som ska användas.
precision integer standard:6 Ställer in antalet decimaler att avrunda till i koordinater. Standardvärdet är 6 decimaler, vilket ger en precision på cirka 10 cm. Om du inte vill att koordinaterna ska avrundas, ställ in värdet på ett negativt tal.

Simplify

Förenklar linje- och områdesgeometrier i ett dataset. Det är ofta användbart att ladda geografiska data med operationen Simplify istället för operationen Load för att få mer effektiva geometrier som är snabbare att visa.

Graden av förenkling beräknas automatiskt baserat på area, antal objekt och objektens storlek. Det är sedan möjligt att justera detta till en högre eller lägre upplösning med parametern resolution.

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

Linjeförenkling görs med en algoritm för brytpunktsreducering.

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-datasetet dataset1.
  • Simplified_<geometry column name> - Förenklade versioner av de ursprungliga geometrierna.
  • Alla kolumner utom nyckelkolumnen från dataset, med datasetets namn som prefix.

Stöder:

  • ScriptEval i laddningsskript.

Exempel som laddar förenklade versioner av amerikanska delstater:

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 string standard:Auto Det resulterande datasetet förenklas och graden av förenkling styrs av denna egenskap. Tillgängliga värden är:
  • Auto - Operationen beräknar en upplösning baserat på data.
  • AutoLow - En upplösning som är lägre än (hälften av) Auto-upplösningen.
  • AutoHigh - En upplösning som är högre än (dubbelt så hög som) Auto-upplösningen.
dataset Dataset standard:<första datasetet> Datasetet med geometrier att förenkla.
precision integer standard:6 Ställer in antalet decimaler att avrunda till i koordinater. Standardvärdet är 6 decimaler, vilket ger en precision på cirka 10 cm. Om du inte vill att koordinaterna ska avrundas, ställ in värdet på ett negativt tal.

TravelAreas

Beräknar ISO-områden för restid. Alla platser inom det returnerade området kan nås inom en viss tid eller är närmare än ett visst avstånd längs vägar. Returnerar en tabell med id, reseområdesgeometri, mittpunkt, kostnad, kostnadsenhet och status (OK eller failed).

Om du använder "bird" som transporttyp genereras geografiskt korrekta cirklar runt ursprungen.

Returnerar följande kolumner:

  • <dataset key column> - Nyckelkolumnen från indata-datasetet.
  • TravelArea - Polygongeometrin som definierar reseområdet.
  • Cost - Kostnaden som anges i costValue eller costField.
  • CostUnit - Kostnadsenheten som anges i costUnit.
  • Status - Den returnerade statusen är antingen "OK" eller "failed:" följt av ett felmeddelande.
  • Alla kolumner utom nyckelkolumnen från indata-datasetet, med datasetets namn som prefix.

Stöder:

  • ScriptEval i laddningsskript.
  • ScriptEvalStr i diagramskript för att hämta reseområdesgeometrin.
  • ScriptEval i diagramskript för att hämta kostnad.

Detta laddningsskriptexempel genererar 10-minuters reseområden i Miami och Orlando från koordinater:

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

Detta laddningsskriptexempel genererar 10-minuters reseområden i Miami och Orlando med hjälp av 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});

Detta är ett exempel som beräknar reseområden runt punkter direkt i ett områdeslager. Operationen anropas för urvalet varje gång urvalet ändras. Detta bör läggas i laddningsskriptet för att ladda data för exemplet:

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

Använd följande dimension i områdeslagret:

LocationDbId

Använd ett beräkningsvillkor i områdeslagret:

Count(LocationDbId)<10

I egenskapen Location lägg in detta:

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

Parametrar för TravelAreas
Parameter Typ Användning Beskrivning
dataset Dataset standard:<första datasetet> Ett dataset med ursprung och valfritt kostnader för reseområdesberäkningarna. Stöder strömning av detta dataset när det skickas från laddningsskriptet, vilket innebär att större tabeller tillåts.
costValue number standard: Ingen. Kostnaden vid gränsen för det returnerade området. Kostnaden kan vara antingen en längd eller en tid. (Se costUnit nedan.) Ett alternativ som tillåter individuella kostnader för varje område är att ange costField istället.
costField string standard: Ingen. Ett fält i datasetet som anger kostnaden. Detta används endast om costValue är tomt.
costUnit string standard:seconds Ska vara en av seconds, minutes, hours, meters, yards, kilometers eller miles. När en tidsenhet används beräknas det område som nås inom den tiden, och när en längdenhet används beräknas området med ett reseavstånd som är kortare än det angivna.
transportation string standard:car Transportmedlet, ett av car, truck, bike, pedestrian eller bird (som flyger i 10 m/s).
precision integer standard:6 Ställer in antalet decimaler att avrunda till i koordinater. Standardvärdet är 6 decimaler, vilket ger en precision på cirka 10 cm. Om du inte vill att koordinaterna ska avrundas, ställ in värdet på ett negativt tal.

Within

Returnerar relationerna mellan två dataset där en geometri i ett dataset (enclosed) är helt inuti området i det andra datasetet (enclosing). Returnerar en tabell som mappar mellan nyckeln i enclosed och nyckeln i enclosing för alla hittade relationer.

Använd within vanligtvis för att hitta vilka områden data befinner sig i; till exempel för att testa GPS-positioner för vilket administrativt område de befinner sig i. Detta är en typ av omvänd geokodning.

Returnerar följande kolumner:

  • <enclosed name>_<enclosing name>_RelationId - En nyckel genererad för relationen mellan de två geometrierna.
  • <enclosed key column> - Nyckelkolumnen från indata-dataset1.
  • <enclosing key column> - Nyckelkolumnen från indata-dataset2.
  • Alla kolumner utom nyckelkolumnen från datasetet enclosed, med datasetets namn som prefix.
  • Alla kolumner utom nyckelkolumnen från datasetet enclosing, med datasetets namn som prefix.

Stöder:

  • ScriptEval i laddningsskript.

För att kompensera för felaktigheter i data är det ibland bättre att använda Closest istället för Within. Till exempel, om du har punktdata i kustområden som du vill relatera till administrativa områden, kan små felaktigheter göra att punkter hamnar något utanför områdena.

Detta är ett laddningsskriptexempel 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 Dataset standard:<första datasetet> Ett dataset med geometrier att testa för vilka områden de omsluts av. Stöder strömning av detta dataset när det skickas från laddningsskriptet, vilket innebär att större tabeller tillåts.
enclosing Dataset standard:<andra datasetet> Ett dataset med områdesgeometrier att testa för vilka geometrier de omsluter. Stöder strömning av detta dataset när det skickas från laddningsskriptet, vilket innebär att större tabeller tillåts.
precision integer standard:6 Ställer in antalet decimaler att avrunda till i koordinater. Standardvärdet är 6 decimaler, vilket ger en precision på cirka 10 cm. Om du inte vill att koordinaterna ska avrundas, ställ in värdet på ett negativt tal.
 

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

Om du stöter på några problem med den här sidan eller innehållet på den, t.ex. ett stavfel, ett saknat steg eller ett tekniskt fel – meddela oss!