Bewerking | Qlik Cloud Help
Ga naar hoofdinhoud Ga naar aanvullende inhoud

Bewerking

AddressPointLookup

Retourneert puntgeometrieën voor adressen in een tabel, oftewel geocodering. Geef een adresreeks op in de eigenschap Search Text of gestructureerde delen in de bijbehorende eigenschappen, zoals Country, Street enz. Combinaties zijn ook toegestaan. Voor deze bewerking is een speciale licentie vereist. Adressen die om wat voor reden dan ook niet konden worden gevonden, worden niet in het resultaat geretourneerd.

De functionaliteit die wordt geboden door Qlik Geocoding (via AddressPointLookup en PointToAddressLookup) verschilt van andere functies voor het opzoeken van een locatie. Qlik Geocoding maakt zoekopdrachten op adresniveau mogelijk, terwijl reguliere zoekopdrachten voor een locatie slechts zo nauwkeurig kunnen zijn als op postcodeniveau.

Wanneer u aan de slag gaat met Qlik Geocoding, gebruikt u de sjabloon waarnaar wordt verwezen in Qlik Geocoding configureren (alleen in het Engels).

Informatie Voor de beste resultaten geeft u de voorkeur aan specifieke gegevens en laat u brede gegevens waar mogelijk weg. Als u bijvoorbeeld zowel een postcode als een plaatsnaam hebt en u erop vertrouwt dat de postcode correct is, kunt u de plaatsnaam het beste niet opgeven.

De meeste parameters zijn er in twee versies: één die de werkelijke waarde specificeert, zoals country="SWE", en één die een veldnaam specificeert waaruit de werkelijke waarde moet worden opgehaald, zoals countryField="CountryIso2".

Informatie U moet de gebruikersrolmachtiging Use : hebben om AddressPointLookup te gebruiken.
Informatie Om Engelse of Pinyin-adressen in China te geocoderen, moet de parameter Country zijn ingesteld op "CHN".

Retourneert de volgende kolommen:

  • <dataset key column> - De sleutelkolom uit de invoerdataset.
  • Address - Het gevonden adres, opgemaakt volgens de adresstandaarden van het land.
  • Geometry - Het punt voor het gevonden item.
  • HouseNumber - Het huisnummer voor het gevonden item.
  • Street - De straat voor het gevonden item.
  • PostalCode - De postcode voor het gevonden item.
  • City - De naam van de administratieve divisie op stadsniveau voor het gevonden item.
  • Adm1 - De naam of afgekorte naam voor de administratieve divisie van de eerste orde (staat/provincie) voor het gevonden item.
  • CountryIso2 - De landcode voor het gevonden item.
  • Match - Een waarde tussen 0 en 1 die aangeeft hoe goed de overeenkomst was. Een waarde van 1 betekent een perfecte overeenkomst.
  • Alle kolommen behalve de sleutelkolom uit dataset, voorafgegaan door de naam van de dataset.

De geretourneerde velden kunnen leeg zijn indien niet van toepassing of wanneer er geen gegevens beschikbaar zijn.

Ondersteunt:

  • ScriptEval in load-scripts.

Voorbeeld dat enkele Zweedse adressen geocodeert waarbij elk item in een eigen veld staat:

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

Dit voorbeeld toont geocodering in een vrije tekststijl:

[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);
Parameters voor AddressPointLookup
Parameter Type Gebruik Beschrijving
searchText string optioneel Een tekstreeks om naar te zoeken. Dit kunnen adressen zijn zoals: "1600 Pennsylvania Ave, Washington DC, USA" of onvolledige adressen die worden gecombineerd met gegevens in andere velden, zoals "1117 Washington Ave" met City ingesteld op "Philadelphia" en Country ingesteld op "USA".
searchTextField string optioneel Als searchText niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven waaruit de informatie moet worden opgehaald.
country string optioneel Een tekenreeks met drieletterige ISO-codes. Er kunnen meerdere landen worden opgegeven, gescheiden door komma's: "SWE,NOR,FIN". Om specifiek Engelse of Pinyin-adressen in China te geocoderen, moet deze parameter zijn ingesteld op "CHN".
countryField string optioneel Als country niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven dat de landnaam of twee- of drieletterige ISO-codes bevat. Merk op dat in tegenstelling tot de andere parameters, de verwachte indeling van de gegevens die zijn opgegeven door country en countryField niet identiek is. De parameter country staat meerdere landen toe, maar alleen in drieletterige ISO-indeling, terwijl countryField verschillende landindelingen toestaat.
state string optioneel Naam of code van de staat/provincie. Voor de meeste landen maakt de staat/provincie geen deel uit van het adres.
stateField string optioneel Als state niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven waaruit de informatie moet worden opgehaald.
city string optioneel Plaatsnaam, gemeente of postplaats.
cityField string optioneel Als city niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven waaruit de informatie moet worden opgehaald.
postalCode string optioneel Postcode.
postalCodeField string optioneel Als postalCode niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven waaruit de informatie moet worden opgehaald.
street string optioneel Straatnaam. In plaats van straat en huisnummer in afzonderlijke parameters of velden op te geven, kunnen beide samen worden opgegeven, gescheiden door een spatie.
streetField string optioneel Als street niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven waaruit de informatie moet worden opgehaald.
houseNumber string optioneel Huisnummer.
houseNumberField string optioneel Als houseNumber niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven waaruit de informatie moet worden opgehaald.
matchThreshold real standaard:0.5 Retourneer alleen resultaten met een betere overeenkomst dan dit. Verhoog deze waarde als er te veel onjuiste treffers worden geretourneerd.
language string standaard: Geen. Een tweeletterige taalcode voor de voorkeurstaal voor het adres in het antwoord. Als het adres niet beschikbaar is in de gevraagde taal, wordt het geretourneerd in een standaardtaal voor de locatie.
dataset Dataset standaard: Geen. Een dataset met adressen die in de geocoder worden opgezocht. Ondersteunt het streamen van deze dataset wanneer deze vanuit het load-script wordt verzonden, wat betekent dat grotere tabellen zijn toegestaan.
precision integer standaard:6 Stelt het aantal decimalen in waarop coördinaten moeten worden afgerond. De standaardwaarde is 6 decimalen, wat een precisie heeft van ongeveer 10 cm. Als u niet wilt dat coördinaten worden afgerond, stelt u de waarde in op een negatief getal.

Binning

Genereert rechthoekige of zeshoekige bins voor een puntdataset. Dit is een manier om puntgegevens te aggregeren, zodat een overzicht van de gegevens efficiënt kan worden weergegeven.

Retourneert de volgende kolommen:

  • <dataset key column> - De sleutelkolom uit de invoerdataset.
  • BinId - Identiteit voor de bin.
  • BinTable.BinPolygon - De polygoon voor de bin.
  • BinTable.CenterPoint - Punt in het midden van de bin.
  • Alle kolommen behalve de sleutelkolom uit dataset, voorafgegaan door de naam van de dataset.

Ondersteunt:

  • ScriptEval in load-scripts.

Voorbeeld dat zeshoekige bins laadt van Amerikaanse luchthavens:

Load * Extension GeoOperations.ScriptEval(' Binning(type="hexagonal", gridSize="1") DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="us" ');
Parameters voor Binning
Parameter Type Gebruik Beschrijving
type string standaard:rectangular Bepaalt of er rectangular (rechthoekige) of hexagonal (zeshoekige) bins moeten worden gegenereerd.
gridSize real standaard: Geen. De hoogte van een individuele bin in graden. Eén graad is ongeveer 10000m.
gridWidthHeightRatio real standaard:1.5 De verhouding tussen breedte en hoogte van bins. Vierkante bins zijn vaak optimaal, maar dat varieert per breedtegraad. De formule voor de optimale verhouding tussen breedte en hoogte is 1/cos(breedtegraad), bijvoorbeeld 1 op de evenaar, 1,15 op breedtegraad +-30 graden en 2 op breedtegraad +-60 graden. Het ziet er vaak beter uit om gebinde gegevens weer te geven in de adaptieve projectie dan in de Mercator-projectie.
dataset Dataset standaard: Geen. De dataset met puntgeometrieën waarvoor bins moeten worden gegenereerd. Ondersteunt het streamen van deze dataset wanneer deze vanuit het load-script wordt verzonden, wat betekent dat grotere tabellen zijn toegestaan.
precision integer standaard:6 Stelt het aantal decimalen in waarop coördinaten moeten worden afgerond. De standaardwaarde is 6 decimalen, wat een precisie heeft van ongeveer 10 cm. Als u niet wilt dat coördinaten worden afgerond, stelt u de waarde in op een negatief getal.

Closest

Retourneert relaties en afstanden tussen objecten in de ene dataset en de dichtstbijzijnde objecten in een andere, als er een dichterbij is dan de maximale afstand. De kosten kunnen ook langs wegen worden berekend, en in dat geval kan optioneel de reistijd worden gebruikt. Deze bewerking is in veel gevallen nuttig, niet alleen om de relaties met de dichtstbijzijnde objecten te verkrijgen, maar ook om afstandsmatrices tussen een reeks punten te verkrijgen.

Retourneert de volgende kolommen:

  • <dataset1 name>_<dataset2 name>_RelationId - Een sleutel die is gegenereerd voor de relatie tussen de twee geometrieën.
  • <dataset1 key column> - De sleutelkolom uit de invoerdataset1.
  • <dataset2 key column> - De sleutelkolom uit de invoerdataset2.
  • Distance - De afstand in de eenheid die is opgegeven in costUnit.
  • Status - De geretourneerde status is "ok" of "failed:" gevolgd door een foutmelding.
  • LowResLine - Een versie met lage resolutie van de routelijn, alleen beschikbaar voor niet- bird afstandstypen.
  • Alle kolommen behalve de sleutelkolom uit de invoerdataset dataset1, voorafgegaan door de naam van de dataset.
  • Alle kolommen behalve de sleutelkolom uit de invoerdataset dataset2, voorafgegaan door de naam van de dataset.

Ondersteunt:

  • ScriptEval in load-scripts.

Dit voorbeeld vindt de dichtstbijzijnde luchthavens bij punten in een tabel:

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);
Parameters voor Closest
Parameter Type Gebruik Beschrijving
distance real standaard: Geen. Maximale afstand vanaf de eenheid die is opgegeven in Cost unit. Items die verder uit elkaar liggen, worden genegeerd.
costUnit string standaard:meters Moet een van de volgende zijn: meters, yards, kilometers, miles, seconds, minutes of hours. Het gebruik van tijdseenheden impliceert dat de reistijd wordt gebruikt als de kosten en lengte-eenheden dat de afstand wordt gebruikt. De tijdseenheden zijn niet toegestaan voor het afstandstype Bird.
distanceType real standaard:Bird Bepaalt hoe afstanden worden gemeten. De volgende waarden zijn toegestaan:
  • Bird - meet directe afstanden (hemelsbreed) tussen objecten.
  • Car - meet langs wegen met autorestricties. Alleen ondersteund voor puntdatasets.
  • Bike - meet langs wegen met fietsrestricties. Alleen ondersteund voor puntdatasets.
  • Pedestrian - meet langs wegen met voetgangersrestricties. Alleen ondersteund voor puntdatasets.
  • Truck - meet langs wegen met vrachtwagenrestricties. Alleen ondersteund voor puntdatasets.
closestCount real standaard:1 Aantal objecten in de tweede dataset dat moet worden gekoppeld aan een object in de eerste dataset. Een waarde van 1 betekent alleen de dichtstbijzijnde, 2 betekent de twee dichtstbijzijnde, enzovoort.
dataset1 Dataset standaard:<eerste dataset> Objecten om te controleren op nabijheid tot objecten in dataset2 indien opgegeven, anders tot objecten in zichzelf. Bij het controleren van de nabijheid tussen objecten in een enkele dataset, worden relaties nooit toegevoegd van een object naar zichzelf. Ondersteunt het streamen van deze dataset wanneer deze vanuit het load-script wordt verzonden en dataset2 is gedefinieerd, wat betekent dat grotere tabellen zijn toegestaan.
dataset2 Dataset standaard:<tweede dataset indien aanwezig> Objecten om te relateren aan objecten in dataset1.
precision integer standaard:6 Stelt het aantal decimalen in waarop coördinaten moeten worden afgerond. De standaardwaarde is 6 decimalen, wat een precisie heeft van ongeveer 10 cm. Als u niet wilt dat coördinaten worden afgerond, stelt u de waarde in op een negatief getal.

Cluster

Produceert clusters uit een puntdataset op basis van geografische nabijheid tussen punten. Het genereren van clusters wordt bestuurd door de parameter distance, die definieert hoe ver een punt verwijderd mag zijn van de cluster waartoe het behoort. Retourneert een tabel met relaties tussen punten en clusters. Retourneert ook een samengevoegde tabel met de naam Clusters met clustergeometrieën. Deze bevat de velden ClusterID, ClusterCenter (puntgeometrie) en PointCount. Het telveld bevat het aantal punten in de cluster.

Retourneert de volgende kolommen:

  • <dataset key column> - De sleutelkolom uit de invoerdataset.
  • ClusterID - Id van de cluster waartoe het punt behoort.
  • Clusters.ClusterPoint - Middelpunt voor cluster.
  • Clusters.PointCount - Aantal oorspronkelijke punten dat tot de cluster behoort.
  • Alle kolommen behalve de sleutelkolom uit de invoerdataset, voorafgegaan door de naam van de dataset.

Ondersteunt:

  • ScriptEval in load-scripts.

Dit voorbeeld clustert luchthavens in de VS, zodat luchthavens die dichter dan 50 km bij elkaar liggen tot één cluster behoren:

MyClusteredAirports: Load * Extension GeoOperations.ScriptEval(' Cluster(distance="50000") DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="us" ');
Parameters voor Cluster
Parameter Type Gebruik Beschrijving
distance real standaard: Geen. De afstand tussen een punt en zijn cluster mag niet groter zijn dan deze afstand in meters.
dataset Dataset standaard: Geen. Een dataset met punten om te clusteren.
precision integer standaard:6 Stelt het aantal decimalen in waarop coördinaten moeten worden afgerond. De standaardwaarde is 6 decimalen, wat een precisie heeft van ongeveer 10 cm. Als u niet wilt dat coördinaten worden afgerond, stelt u de waarde in op een negatief getal.

Dissolve

Lost gebieden op en vereenvoudigt ze om grotere gebieden te vormen op basis van de toewijzing tussen oude gebiedsidentiteiten (of geometrieën) en nieuwe gebiedsidentiteiten. Dit wordt doorgaans gebruikt voor het bouwen van aangepaste gebieden die zijn opgebouwd uit kleinere, goed gedefinieerde gebieden, zoals postgebieden of administratieve gebieden.

Retourneert de volgende kolommen:

  • <dissolveField> - Het veld dat is opgegeven als dissolveField in de invoergegevens.
  • DissolvedPolygon - De geometrieën van de nieuwe opgeloste gebieden.

Ondersteunt:

  • ScriptEval in load-scripts.

De geometriedataset is optioneel. Indien niet opgegeven, worden geometrieën verondersteld beschikbaar te zijn in de dataset met de oplossingsdefinitie.

Merk op dat overlappingen van polygonen worden verwijderd in alle resoluties behalve Source.

Dit voorbeeld maakt twee regio's, één bestaande uit CA en AZ en één bestaande uit WA en 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);
Parameters voor Dissolve
Parameter Type Gebruik Beschrijving
dissolveField string standaard:<dezelfde naam als het sleutelveld in dissolveDataset> De naam van het veld met identiteiten van de nieuwe gebieden in dissolveDataset.
resolution string standaard:Auto De resulterende dataset wordt vereenvoudigd en de mate van vereenvoudiging wordt bestuurd door deze eigenschap. Beschikbare waarden zijn:
  • auto - De bewerking berekent een resolutie op basis van de gegevens.
  • autolow - Een resolutie die lager is dan (de helft van) de Auto-resolutie.
  • autohigh - Een resolutie die hoger is dan (het dubbele van) de Auto-resolutie.
  • source - Er wordt geen vereenvoudiging uitgevoerd. Merk op dat als dissolveDataset dezelfde oude gebieden twee keer bevat in twee verschillende nieuwe gebieden, source moet worden gebruikt.
areaDatasetKeyField string standaard:<sleutelveld in areaDataset> De identiteiten van de oorspronkelijke gebieden in areaDataset. Dit wordt alleen gebruikt als areaDataset is opgegeven.
dissolveDataset Dataset standaard:<eerste dataset> De definitie van tot welk nieuw gebied elk oud gebied behoort, d.w.z. een toewijzing tussen oude gebieds- en nieuwe gebiedsidentiteiten. Het sleutelveld moet worden toegewezen aan de sleutels in areaDataset indien opgegeven. Als er geen areaDataset is opgegeven, moeten de geometrieën beschikbaar zijn in deze dataset.
areaDataset Dataset standaard:<tweede dataset indien aanwezig> De dataset met gebiedsgeometrieën om op te lossen. Kan geen zijn, wat betekent dat de geometrieën beschikbaar moeten zijn in dissolveDataset. Het areaDatasetKeyField in deze dataset moet zijn gekoppeld aan het sleutelveld in dissolveDataset.
precision integer standaard:6 Stelt het aantal decimalen in waarop coördinaten moeten worden afgerond. De standaardwaarde is 6 decimalen, wat een precisie heeft van ongeveer 10 cm. Als u niet wilt dat coördinaten worden afgerond, stelt u de waarde in op een negatief getal.

Intersects

Retourneert een tabel die toewijst tussen de sleutel in dataset1 en de sleutel in dataset2 voor alle objecten die elkaar snijden. Als beide datasets polygonen bevatten, wordt het relatieve overlappingsgebied vergeleken met de gebieden in de respectievelijke dataset geretourneerd.

Het is mogelijk om het aantal snijdende geometrieën in de tweede dataset dat moet worden toegewezen aan elke geometrie in de eerste dataset te beperken door intersectsCount op te geven. Vervolgens worden de meest snijdende geometrieën in volgorde geretourneerd. De bewerking is symmetrisch als intersectsCount niet is opgegeven.

Retourneert de volgende kolommen:

  • <dataset1 name>_<dataset2 name>_RelationId - Een sleutel die is gegenereerd voor de relatie tussen de twee geometrieën.
  • <dataset1 key column> - De sleutelkolom uit de invoerdataset1.
  • <dataset2 key column> - De sleutelkolom uit de invoerdataset2.
  • <dataset1 name>.RelativeOverlap - De overlapping vergeleken met de polygoon in dataset1. Wordt alleen geretourneerd als beide datasets polygonen bevatten. Er is een prestatieverlies bij het opvragen van dit veld.
  • <dataset2 name>.RelativeOverlap - De overlapping vergeleken met de polygoon in dataset2. Wordt alleen geretourneerd als beide datasets polygonen bevatten. Er is een prestatieverlies bij het opvragen van dit veld.
  • Alle kolommen behalve de sleutelkolom uit de invoerdataset dataset1, voorafgegaan door de naam van de dataset.
  • Alle kolommen behalve de sleutelkolom uit de invoerdataset dataset2, voorafgegaan door de naam van de dataset.

Ondersteunt:

  • ScriptEval in load-scripts.

Dit voorbeeld berekent welke staten sommige lijnen snijden:

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);
Parameters voor Intersects
Parameter Type Gebruik Beschrijving
dataset1 Dataset standaard:<eerste dataset> Een dataset met geometrieën om te testen welke de geometrieën in de andere dataset snijden indien opgegeven, of tussen objecten in deze dataset indien niet. Bij het controleren van snijpunten tussen objecten in een enkele dataset, worden relaties nooit toegevoegd van een object naar zichzelf. Ondersteunt het streamen van deze dataset wanneer deze vanuit het load-script wordt verzonden en wanneer dataset2 is gedefinieerd, wat betekent dat grotere tabellen zijn toegestaan.
dataset2 Dataset standaard:<tweede dataset indien aanwezig> Een dataset met geometrieën om te testen welke de geometrieën in de andere dataset snijden. Indien niet opgegeven, wordt het snijpunt tussen objecten in dataset1 berekend.
intersectsCount integer standaard:0 Indien groter dan 0, wordt maximaal dit aantal snijdende geometrieën in dataset2 geretourneerd per dataset1-geometrie. Alleen degenen die het meest snijden (grootste overlappende gebied of lengte) worden geretourneerd.
precision integer standaard:6 Stelt het aantal decimalen in waarop coördinaten moeten worden afgerond. De standaardwaarde is 6 decimalen, wat een precisie heeft van ongeveer 10 cm. Als u niet wilt dat coördinaten worden afgerond, stelt u de waarde in op een negatief getal.

IpLookup

Retourneert locatie-informatie en puntgeometrieën voor IP-adressen in een tabel. Dit is handig wanneer u toegangsgegevens tot webservices analyseert. De geretourneerde tabel bevat de volgende velden:
  • Sleutelveld - Hetzelfde als het sleutelveld voor de naamtabel.
  • <Address Table Ip Field> - Hetzelfde als het IP-veld dat is opgezocht. Alleen beschikbaar indien niet hetzelfde als het sleutelveld.
  • IpPoint - Het punt voor het gevonden item.
  • CountryIso2 - De landcode voor het gevonden item.
  • Adm1Code - De code voor het administratieve gebied van de eerste orde voor het gevonden item. Merk op dat deze code niet altijd compatibel is met de code die wordt geretourneerd door de locatieservice.
  • City - De stad voor het gevonden item.
  • Alle kolommen behalve de sleutelkolom uit de invoerdataset, voorafgegaan door de naam van de dataset.

IP-geolocatie is inherent onnauwkeurig. Voor veel IP-adressen is het mogelijk om een stad aan te wijzen, maar voor andere kan alleen het land worden opgelost.

De beste werkwijze is om alleen de IP-kolom naar de bewerking IpLookup te verzenden. Voorbeeld dat enkele IP-adressen opzoekt:

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

Het komt vaak voor dat hetzelfde IP-adres in veel rijen wordt herhaald. Het verbetert dan de prestaties om eerst alleen de unieke IP's eruit te filteren, zoals in dit voorbeeld:

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;

Dit product bevat GeoLite2-gegevens gemaakt door MaxMind, beschikbaar via MaxMind.

Parameters voor IpLookup
Parameter Type Gebruik Beschrijving
ipField string optioneel Het veld met het IP-adres dat moet worden opgezocht. Gebruikt het sleutelveld van de dataset indien niet opgegeven.
dataset Dataset standaard: Geen. Een dataset met IP-adressen die in de geocoder worden opgezocht. Ondersteunt het streamen van deze dataset wanneer deze vanuit het load-script wordt verzonden, wat betekent dat grotere tabellen zijn toegestaan.
precision integer standaard:6 Stelt het aantal decimalen in waarop coördinaten moeten worden afgerond. De standaardwaarde is 6 decimalen, wat een precisie heeft van ongeveer 10 cm. Als u niet wilt dat coördinaten worden afgerond, stelt u de waarde in op een negatief getal.

Load

Laadt de dataset zonder dat er een bewerking is toegepast. Dit maakt het mogelijk om alle indelingen te laden die GeoOperations ondersteunt. Merk op dat Simplify een goed alternatief kan zijn voor Load als geometrieën gedetailleerd zijn en traag worden weergegeven.

Retourneert de volgende kolommen:

  • Alle kolommen uit dataset.

Ondersteunt:

  • ScriptEval in load-scripts.

Voorbeeld dat postcodes uit Zweden laadt:

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

Aangezien WKT wordt ondersteund als geometrie-indeling voor gegevens in INTABLE, is de bewerking Load uitstekend geschikt voor het converteren van geografische geometrieën die uit een database zijn geladen naar de Sense-geometrie-indeling, zodat deze kan worden weergegeven. Het volgende voorbeeld laat zien hoe u WKT-gegevens converteert, in dit geval uit de tabel 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);
Parameters voor Load
Parameter Type Gebruik Beschrijving
dataset Dataset standaard:<eerste dataset> Dataset om te laden. Ondersteunt het streamen van deze dataset wanneer deze vanuit het load-script wordt verzonden, wat betekent dat grotere tabellen zijn toegestaan.
precision integer standaard:6 Stelt het aantal decimalen in waarop coördinaten moeten worden afgerond. De standaardwaarde is 6 decimalen, wat een precisie heeft van ongeveer 10 cm. Als u niet wilt dat coördinaten worden afgerond, stelt u de waarde in op een negatief getal.

PointToAddressLookup

Retourneert het dichtstbijzijnde adres voor punten in de lijst, ook wel reverse geocoding genoemd. Voor deze bewerking is een speciale licentie vereist. Punten die dicht bij straten liggen, krijgen adressen op straatniveau, anders valt het terug op het retourneren van treffers op postgebied- of stadsniveau. Voor punten die te ver weg liggen, worden geen gegevens geretourneerd.

Informatie U moet de gebruikersrolmachtiging Use : hebben om PointToAddressLookup te gebruiken.

Retourneert de volgende kolommen:

  • <dataset key column> - De sleutelkolom uit de invoerdataset.
  • Address - Het gevonden adres, opgemaakt volgens de adresstandaarden van het land.
  • Geometry - Het punt voor het gevonden item.
  • HouseNumber - Het huisnummer voor het gevonden item.
  • Street - De straat voor het gevonden item.
  • PostalCode - De postcode voor het gevonden item.
  • City - De naam van de administratieve divisie op stadsniveau voor het gevonden item.
  • Adm1 - De naam of afgekorte naam voor de administratieve divisie van de eerste orde (staat/provincie) voor het gevonden item.
  • CountryIso2 - De landcode voor het gevonden item.
  • Distance - Afstand in meters tot het gevonden adres.
  • Alle kolommen behalve de sleutelkolom uit dataset, voorafgegaan door de naam van de dataset.

Merk op dat de geretourneerde velden leeg kunnen zijn indien niet van toepassing of wanneer er geen gegevens beschikbaar zijn.

Voorbeeld dat de adressen voor enkele punten ophaalt:

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);
Parameters voor PointToAddressLookup
Parameter Type Gebruik Beschrijving
language string standaard: Een tweeletterige taalcode voor de voorkeurstaal voor het adres in het antwoord. Als het adres niet beschikbaar is in de gevraagde taal, wordt het geretourneerd in een standaardtaal voor de locatie.
dataset Dataset standaard: Geen. Een dataset met punten die in de geocoder worden opgezocht. Ondersteunt het streamen van deze dataset wanneer deze vanuit het load-script wordt verzonden, wat betekent dat grotere tabellen zijn toegestaan.
precision integer standaard:6 Stelt het aantal decimalen in waarop coördinaten moeten worden afgerond. De standaardwaarde is 6 decimalen, wat een precisie heeft van ongeveer 10 cm. Als u niet wilt dat coördinaten worden afgerond, stelt u de waarde in op een negatief getal.

Routes

Berekent routes, inclusief lengte en duur, tussen twee locaties in een tabel.

Merk op dat de oorsprong de geometriekolom in de dataset is. De bestemmingskolom wordt opgegeven in bewerkingsparameters, aangezien datasets slechts één geometriekolom kennen.

Als u bird als transporttype gebruikt, genereert het grootcirkelbogen tussen oorsprongen en bestemmingen.

Retourneert de volgende kolommen:

  • <dataset key column> - De sleutelkolom uit de invoerdataset.
  • Distance - De routeafstand in meters.
  • Duration - De geschatte reistijd van de route in seconden.
  • Status - De geretourneerde status is "ok" of "failed:" gevolgd door een foutmelding.
  • LowResLine - Een versie met lage resolutie van de routelijn.
  • Alle kolommen behalve de sleutelkolom uit de invoerdataset, voorafgegaan door de naam van de dataset.

Ondersteunt:

  • ScriptEval in load-scripts.
  • ScriptEvalStr in diagramscripts om de route op te halen.
  • ScriptEval in diagramscripts om de afstand of duur op te halen.

Dit is een voorbeeld dat routes berekent tussen punten in een 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);

Dit is een voorbeeld dat routes rechtstreeks in een Lijnlaag berekent. De bewerking wordt voor de selectie aangeroepen telkens wanneer de selectie verandert. Normaal gesproken moet er een berekeningsvoorwaarde zijn die waar is als er slechts een paar punten zijn geselecteerd (anders is het beter om de routes in het load-script te berekenen). Dit moet in het load-script worden geplaatst om de gegevens te laden. Bijvoorbeeld:

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

Gebruik de volgende dimensie in de Lijnlaag:

LocationDbId

Gebruik een berekeningsvoorwaarde in de Lijnlaag:

Count(LocationDbId)<10

In de eigenschap Locatie, die moet zijn ingesteld op Line geometry, plaatst u dit om de routes van een vaste positie naar de geselecteerde punten te berekenen:

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

Parameters voor Routes
Parameter Type Gebruik Beschrijving
dataset Dataset standaard: Geen. Een dataset met oorsprongen en bestemmingen voor de te berekenen routes. De oorsprongen moeten zich in de geometrie van de dataset bevinden. Ondersteunt het streamen van deze dataset wanneer deze vanuit het load-script wordt verzonden, wat betekent dat grotere tabellen zijn toegestaan.
criteria string standaard:fastest Kies tussen fastest (snelste) of shortest (kortste) route die moet worden berekend.
transportation string standaard:car De transportmodus, een van car, truck, bike, pedestrian of bird (die vliegt met 10 m/s).
destField string standaard: Geen. Het veld in de dataset dat de bestemming specificeert. Merk op dat de oorsprong het geometrieveld is dat in de dataset is opgegeven.
geometryType string standaard:POINT Type geometrie in destField. Toegestane waarden zijn Point, NamedPoint en LatLon. In het geval van benoemde punten wordt de geometrie opgezocht in de locatieservice en wordt er een kolom voor de geometrie toegevoegd.
suffix string standaard: Geen. Voor geavanceerde gebruikers. De opgegeven tekenreeks wordt toegevoegd aan alle ID's. Dit is een handige manier om meer informatie op te geven aan servergebaseerde locatieservices, zoals landcode of type. Het alternatief is om de extra gegevens toe te voegen bij het laden van de tabel in Qlik. Met het volgende achtervoegsel worden alle items gespecificeerd als steden in Zweden:
,SE:city
Zie de Location Service Guide voor meer informatie over de te gebruiken syntaxis.
precision integer standaard:6 Stelt het aantal decimalen in waarop coördinaten moeten worden afgerond. De standaardwaarde is 6 decimalen, wat een precisie heeft van ongeveer 10 cm. Als u niet wilt dat coördinaten worden afgerond, stelt u de waarde in op een negatief getal.

Simplify

Vereenvoudigt lijn- en gebiedsgeometrieën in een dataset. Het is vaak nuttig om geografische gegevens te laden met de bewerking Simplify in plaats van de bewerking Load om efficiëntere geometrieën te krijgen die sneller kunnen worden weergegeven.

De mate van vereenvoudiging wordt automatisch berekend op basis van gebied, aantal objecten en grootte van objecten. Het is vervolgens mogelijk om dat aan te passen naar een hogere of lagere resolutie met de parameter resolution.

Gebiedsvereenvoudiging wordt gedaan met een algoritme dat topologieën verwerkt en gaten kan verwijderen en eilanden kan samenvoegen.

Lijnvereenvoudiging wordt gedaan met een algoritme voor breekpuntreductie.

Merk op dat overlappingen van polygonen worden verwijderd. Er zullen geen overlappende polygonen in de uitvoer zijn.

Retourneert de volgende kolommen:

  • <dataset key column> - De sleutelkolom uit de invoer dataset1.
  • Simplified_<geometry column name> - Vereenvoudigde versies van de oorspronkelijke geometrieën.
  • Alle kolommen behalve de sleutelkolom uit dataset, voorafgegaan door de naam van de dataset.

Ondersteunt:

  • ScriptEval in load-scripts.

Voorbeeld dat vereenvoudigde versies van Amerikaanse staten laadt:

Load * Extension GeoOperations.ScriptEval(' SELECT LocationDbId, Simplified_LocationPolygon FROM Simplify() DATASOURCE states LOCATIONSERVICE type="State", country="us" ');
Parameters voor Simplify
Parameter Type Gebruik Beschrijving
resolution string standaard:Auto De resulterende dataset wordt vereenvoudigd en de mate van vereenvoudiging wordt bestuurd door deze eigenschap. Beschikbare waarden zijn:
  • Auto - De bewerking berekent een resolutie op basis van de gegevens.
  • AutoLow - Een resolutie die lager is dan (de helft van) de Auto-resolutie.
  • AutoHigh - Een resolutie die hoger is dan (het dubbele van) de Auto-resolutie.
dataset Dataset standaard:<eerste dataset> De dataset met geometrieën om te vereenvoudigen.
precision integer standaard:6 Stelt het aantal decimalen in waarop coördinaten moeten worden afgerond. De standaardwaarde is 6 decimalen, wat een precisie heeft van ongeveer 10 cm. Als u niet wilt dat coördinaten worden afgerond, stelt u de waarde in op een negatief getal.

TravelAreas

Berekent ISO-gebieden voor reistijd. Alle locaties binnen het geretourneerde gebied kunnen binnen een bepaalde tijd worden bereikt of zijn dichterbij dan een bepaalde afstand langs wegen. Retourneert een tabel met id, geometrie van het reisgebied, middelpunt, kosten, kosteneenheid en status (OK of mislukt).

Als u "bird" als transporttype gebruikt, genereert het geografisch correcte cirkels rond de oorsprongen.

Retourneert de volgende kolommen:

  • <dataset key column> - De sleutelkolom uit de invoerdataset.
  • TravelArea - De polygoongeometrie die het reisgebied definieert.
  • Cost - De kosten zoals opgegeven in de costValue of costField.
  • CostUnit - De kosteneenheid zoals opgegeven in costUnit.
  • Status - De geretourneerde status is "OK" of "failed:" gevolgd door een foutmelding.
  • Alle kolommen behalve de sleutelkolom uit de invoerdataset, voorafgegaan door de naam van de dataset.

Ondersteunt:

  • ScriptEval in load-scripts.
  • ScriptEvalStr in diagramscripts om de geometrie van het reisgebied op te halen.
  • ScriptEval in diagramscripts om de kosten op te halen.

Dit load-scriptvoorbeeld genereert reisgebieden van 10 minuten in Miami en Orlando op basis van coördinaten:

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

Dit load-scriptvoorbeeld genereert reisgebieden van 10 minuten in Miami en Orlando met behulp van benoemde punten:

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

Dit is een voorbeeld dat Reisgebieden rond punten rechtstreeks in een Gebiedslaag berekent. De bewerking wordt voor de selectie aangeroepen telkens wanneer de selectie verandert. Dit moet in het load-script worden geplaatst om de gegevens voor het voorbeeld te laden:

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

Gebruik de volgende dimensie in de Gebiedslaag:

LocationDbId

Gebruik een berekeningsvoorwaarde in de Gebiedslaag:

Count(LocationDbId)<10

Plaats dit in de eigenschap Locatie:

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

Parameters voor TravelAreas
Parameter Type Gebruik Beschrijving
dataset Dataset standaard:<eerste dataset> Een dataset met oorsprongen en optioneel kosten voor de berekeningen van het reisgebied. Ondersteunt het streamen van deze dataset wanneer deze vanuit het load-script wordt verzonden, wat betekent dat grotere tabellen zijn toegestaan.
costValue number standaard: Geen. De kosten aan de grens van het geretourneerde gebied. De kosten kunnen een lengte of een tijd zijn. (Zie costUnit hieronder.) Een alternatief dat individuele kosten voor elk gebied toestaat, is om in plaats daarvan costField op te geven.
costField string standaard: Geen. Een veld in de dataset dat de kosten specificeert. Dit wordt alleen gebruikt als costValue leeg is.
costUnit string standaard:seconds Moet een van de volgende zijn: seconds, minutes, hours, meters, yards, kilometers of miles. Wanneer een tijdseenheid wordt gebruikt, wordt het gebied berekend dat binnen die tijd wordt bereikt, en wanneer een lengte-eenheid wordt gebruikt, wordt het gebied berekend met een reisafstand die korter is dan opgegeven.
transportation string standaard:car De transportmodus, een van car, truck, bike, pedestrian of bird (die vliegt met 10 m/s).
precision integer standaard:6 Stelt het aantal decimalen in waarop coördinaten moeten worden afgerond. De standaardwaarde is 6 decimalen, wat een precisie heeft van ongeveer 10 cm. Als u niet wilt dat coördinaten worden afgerond, stelt u de waarde in op een negatief getal.

Within

Retourneert de relaties tussen twee datasets waarbij een geometrie in de ene dataset (ingesloten) zich volledig binnen het gebied in de andere dataset (omsluitend) bevindt. Retourneert een tabel die toewijst tussen de sleutel in ingesloten en de sleutel in omsluitend voor alle gevonden relaties.

Gebruik within doorgaans om te vinden in welke gebieden de gegevens zich bevinden; bijvoorbeeld om de GPS-positie te testen voor welk administratief gebied ze zich bevinden. Dit is een soort reverse geocoding.

Retourneert de volgende kolommen:

  • <enclosed name>_<enclosing name>_RelationId - Een sleutel die is gegenereerd voor de relatie tussen de twee geometrieën.
  • <enclosed key column> - De sleutelkolom uit de invoerdataset1.
  • <enclosing key column> - De sleutelkolom uit de invoerdataset2.
  • Alle kolommen behalve de sleutelkolom uit de enclosed dataset, voorafgegaan door de naam van de dataset.
  • Alle kolommen behalve de sleutelkolom uit de enclosing dataset, voorafgegaan door de naam van de dataset.

Ondersteunt:

  • ScriptEval in load-scripts.

Om te compenseren voor onnauwkeurigheden in gegevens, is het soms beter om Closest te gebruiken in plaats van Within. Als u bijvoorbeeld puntgegevens in kustgebieden hebt die u wilt relateren aan administratieve gebieden, kunnen kleine onnauwkeurigheden ervoor zorgen dat punten net buiten de gebieden vallen.

Dit is een load-scriptvoorbeeld dat berekent welke punten zich binnen welke staten bevinden:

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);
Parameters voor Within
Parameter Type Gebruik Beschrijving
enclosed Dataset standaard:<eerste dataset> Een dataset met geometrieën om te testen door welke gebieden ze worden ingesloten. Ondersteunt het streamen van deze dataset wanneer deze vanuit het load-script wordt verzonden, wat betekent dat grotere tabellen zijn toegestaan.
enclosing Dataset standaard:<tweede dataset> Een dataset met gebiedsgeometrieën om te testen welke geometrieën ze omsluiten. Ondersteunt het streamen van deze dataset wanneer deze vanuit het load-script wordt verzonden, wat betekent dat grotere tabellen zijn toegestaan.
precision integer standaard:6 Stelt het aantal decimalen in waarop coördinaten moeten worden afgerond. De standaardwaarde is 6 decimalen, wat een precisie heeft van ongeveer 10 cm. Als u niet wilt dat coördinaten worden afgerond, stelt u de waarde in op een negatief getal.
 

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een tikfout, een ontbrekende stap of een technische fout – laat het ons weten!