Ga naar hoofdinhoud Ga naar aanvullende inhoud

Bewerking

AddressPointLookup

Retourneert puntgeometrieën voor adressen in een tabel, dat wil zeggen, geocodering. Geef een adrestekenreeks op in de eigenschap Zoektekst of gestructureerde onderdelen in de corresponderende eigenschappen, zoals Land, Straat enzovoort. Combinaties zijn ook toegestaan. Deze bewerking vereist een speciale licentie. Adressen die om een of andere reden niet kunnen worden gevonden, worden niet geretourneerd in het resultaat.

De functionaliteit die Qlik GeoCoding biedt (via AddressPointLookup en PointToAddressLookup) wijkt af van andere functies voor het opzoeken van locaties. Met Qlik GeoCoding kunt u zoekopdrachten uitvoeren op adresniveau, terwijl dit bij gangbare zoekopdrachten alleen mogelijk is op postcodeniveau.

Als u aan de slag gaat met Qlik GeoCoding, gebruik dan het 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 weg waar mogelijk. Als u bijvoorbeeld zowel een postcode als een gemeente hebt en u zeker weet dat de postcode juist is, kunt u de gemeente het beste niet opgeven.

De meeste parameters zijn beschikbaar in twee versies, een die de werkelijke waarde opgeeft, zoals country="SWE", en een die een veldnaam opgeeft waaruit de werkelijke waarde kan worden opgehaald, zoals countryField="CountryIso2".

Informatie Om Engelse of Pinyin-adressen in China te geocoderen, moet de parameter Country worden ingesteld op "CHN".

Retourneert de volgende kolommen:

  • <dataset key column> - de sleutelkolom uit de invoergegevensverzameling.
  • Address - het gevonden adres, in de standaardadresindeling 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 het bestuursdistrict op gemeentelijk niveau voor het gevonden item.
  • Adm1 - de naam of afgekorte naam voor het bestuursdistrict van het eerste bestuurlijke niveau (staat/provincie) voor het gevonden item.
  • CountryIso2 - de landcode voor het gevonden item.
  • Match - Een waarde tussen 0 en 1 die weergeeft hoe goed de overeenkomst was. Een waarde van 1 betekent een perfecte overeenkomst.
  • Alle kolommen behalve de sleutelkolom uit de gegevensverzameling, met als prefix de naam van de gegevensverzameling.

De geretourneerde velden zijn mogelijk leeg als ze niet van toepassing zijn of als er geen gegevens beschikbaar zijn.

Ondersteunt:

  • ScriptEval in load-scripts.

In dit voorbeeld worden Zweedse adressen gegeocodeerd waarbij elk item in zijn 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);

In dit voorbeeld wordt geocodering in een vrije-tekststijl weergegeven:

[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
Parameters Type Gebruik Beschrijving
searchText tekenreeks optioneel Een tekenreeks van tekst om naar te zoeken. Dit kunnen adressen zijn, zoals: "1600 Pennsylvania Ave, Washington DC, VS" of onvolledige adressen die zijn gecombineerd met gegevens in andere velden, zoals "1117 Washington Ave" en met City ingesteld op "Philadelphia" en Country ingesteld op "VS".
searchTextField tekenreeks optioneel Als searchText niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven waaruit de informatie kan worden opgehaald.
country tekenreeks optioneel Een reeks met ISO-codes van drie letters. Er kunnen meerdere landen worden opgegeven, gescheiden door komma's: "SWE,NOR,FIN". Om Engelse of Pinyin-adressen in China te geocoderen, moet de parameter Country worden ingesteld op "CHN".
countryField tekenreeks optioneel Als country niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven dat de landnaam of de ISO-codes van twee of drie letters bevat. Merk op dat de verwachte indeling van de gegevens opgegeven in country en countryField niet identiek is, in tegenstelling tot de andere parameters. Voor de parameter country zijn meerdere landen toegestaan, maar alleen in de ISO-indeling met drie letters, terwijl countryField verschillende landindelingen toestaat.
state tekenreeks optioneel Naam of code van staat. Voor de meeste landen vormt de staat geen onderdeel van het adres.
stateField tekenreeks optioneel Als state niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven waaruit de informatie kan worden opgehaald.
city tekenreeks optioneel Naam van stad of gemeente.
cityField tekenreeks optioneel Als city niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven waaruit de informatie kan worden opgehaald.
postalCode tekenreeks optioneel Postcode.
postalCodeField tekenreeks optioneel Als postalCode niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven waaruit de informatie kan worden opgehaald.
street tekenreeks optioneel Straatnaam. In plaats van straatnaam en huisnummer in afzonderlijke parameters of velden op te geven, kunt u beide samen opgeven, gescheiden door een spatie.
streetField tekenreeks optioneel Als street niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven waaruit de informatie kan worden opgehaald.
houseNumber tekenreeks optioneel Huisnummer.
houseNumberField tekenreeks optioneel Als houseNumber niet is opgegeven, kan deze parameter worden gebruikt om een veld op te geven waaruit de informatie kan worden opgehaald.
matchThreshold real standaard:0.5 Retourneer alleen resultaten met een betere overeenkomst dan dit. Verhoog deze waarde als te veel valse treffers worden gevonden.
language tekenreeks standaard: Geen. Een landcode van twee letters voor de voorkeurstaal voor het adres in het antwoord. Als het adres niet beschikbaar is in de gevraagde taal, wordt dit geretourneerd in een standaardtaal voor de locatie.
dataset Gegevensverzameling standaard: Geen. Een gegevensverzameling met adressen die worden opgezocht in de geocoder. Ondersteunt streaming van deze gegevensverzameling wanneer deze wordt verzonden vanuit het load-script, wat betekent dat grotere tabellen zijn toegestaan.
precisie geheel getal standaard:6 Stelt het aantal decimalen in voor het afronden van coördinaten. De standaardwaarde is 6 decimalen, dat overeenkomt met circa 10 cm. Als u niet wilt dat coördinaten worden afgerond, moet u voor de waarde een negatief getal invoeren.

Binning

Genereert rechthoekige of hexagonale bins voor een gegevensverzameling van punten. 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 invoergegevensverzameling.
  • 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 de gegevensverzameling, met als prefix de naam van de gegevensverzameling.

Ondersteunt:

  • ScriptEval in load-scripts.

In dit voorbeeld worden hexagonale bins van luchthavens in de VS geladen:

Load * Extension GeoOperations.ScriptEval(' Binning(type="hexagonal", gridSize="1") DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="us" ');
Parameters voor Binning
Parameters Type Gebruik Beschrijving
type tekenreeks standaard:rechthoekig Bepaalt of rechthoekige of hexagonale bins moeten worden gegenereerd.
gridSize real standaard: Geen. De hoogte van een individuele bin in graden. Eén graad is ongeveer 10.000 m.
gridWidthHeightRatio real standaard:1.5 De breedte-hoogteverhouding van bins. Vaak zijn vierkante bins optimaal, maar dat verschilt per latitude. De formule voor de optimale breedte-hoogteverhouding is 1/cos(latitude), bijvoorbeeld 1 op de evenaar , 1,15 op latitude +-30 graden en 2 op latitude +-60 graden. Het ziet er vaak beter uit om gegevens in bins weer te geven in de adaptieve projectie dan in de Mercator-projectie.
dataset Gegevensverzameling standaard: Geen. De gegevensverzameling met puntgeometrieën waarvoor bins moeten worden gegenereerd. Ondersteunt streaming van deze gegevensverzameling wanneer deze wordt verzonden vanuit het load-script, wat betekent dat grotere tabellen zijn toegestaan.
precisie geheel getal standaard:6 Stelt het aantal decimalen in voor het afronden van coördinaten. De standaardwaarde is 6 decimalen, dat overeenkomt met circa 10 cm. Als u niet wilt dat coördinaten worden afgerond, moet u voor de waarde een negatief getal invoeren.

Closest

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

Retourneert de volgende kolommen:

  • <dataset1 name>_<dataset2 name>_RelationId - een sleutel gegenereerd voor de relatie tussen de twee geometrieën.
  • <dataset1 key column> - de sleutelkolom uit de invoergegevensverzameling1.
  • <dataset2 key column> - de sleutelkolom uit de invoergegevensverzameling2.
  • Distance - de afstand in de eenheid vermeld in costUnit.
  • Status - de geretourneerde status is "ok" of "mislukt:" gevolgd door een foutmelding.
  • LowResLine - een versie van de routelijn met lage resolutie, slechts beschikbaar voor andere afstandstypen dan bird (hemelsbreed).
  • Alle kolommen behalve de sleutelkolom uit de invoergegevensverzameling dataset1, met als prefix de naam van de gegevensverzameling.
  • Alle kolommen behalve de sleutelkolom uit de invoergegevensverzameling dataset2, met als prefix de naam van de gegevensverzameling.

Ondersteunt:

  • ScriptEval in load-scripts.

In dit voorbeeld worden de luchthavens gevonden die zich het dichtst bij de punten in een tabel bevinden:

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
Parameters Type Gebruik Beschrijving
distance real standaard: Geen. Maximale afstand van de eenheid vermeld in Kosteneenheid. Items die zich verder van elkaar bevinden dan deze afstand worden genegeerd.
costUnit tekenreeks standaard:meters Moet een van de volgende zijn: meters, yards, kilometers, mijlen, seconden, minuten of uren. Het gebruik van tijdseenheden impliceert dat kosten worden berekend op basis van de reistijd en het gebruik van lengte-eenheden impliceert dat kosten worden berekend op basis van de afstand. De tijdseenheden zijn niet toegestaan voor het afstandstype Bird (hemelsbreed).
distanceType real standaard:Bird Bepaalt hoe afstanden worden gemeten. De volgende waarden zijn toegestaan:
  • Bird - meting van directe afstanden (terwijl de kraai vliegt) tussen objecten.
  • Car - meting van afstanden via het wegennet met beperkingen voor auto's. Alleen ondersteund voor gegevensverzamelingen met punten.
  • Bike - meting van afstanden via het wegennet met beperkingen voor fietsen. Alleen ondersteund voor gegevensverzamelingen met punten.
  • Pedestrian - meting van afstanden via het wegennet met beperkingen voor voetgangers. Alleen ondersteund voor gegevensverzamelingen met punten.
  • Truck - meting van afstanden via het wegennet met beperkingen voor vrachtauto's. Alleen ondersteund voor gegevensverzamelingen met punten.
closestCount real standaard:1 Aantal objecten in de tweede gegevensverzameling te koppelen aan een object in de eerste gegevensverzameling. De waarde 1 staat voor alleen het dichtstbijzijnde, 2 betekent de twee dichtstbijzijnde enzovoort.
dataset1 Gegevensset standaard:<first dataset> Objecten te controleren op afstand tot objecten in gegevensverzameling2, indien opgegeven, anders tot objecten in dezelfde gegevensverzameling. Bij het controleren van afstanden tussen objecten in één gegevensverzameling worden relaties nooit toegevoegd van een object tot zichzelf. Ondersteunt streaming van deze gegevensverzameling wanneer deze wordt verzonden vanuit het load-script en wanneer dataset2 is gedefinieerd, wat betekent dat grotere tabellen zijn toegestaan.
dataset2 Gegevensset standaard:<second dataset if any> Objecten die gerelateerd moeten worden met objecten in dataset1.
precisie geheel getal standaard:6 Stelt het aantal decimalen in voor het afronden van coördinaten. De standaardwaarde is 6 decimalen, dat overeenkomt met circa 10 cm. Als u niet wilt dat coördinaten worden afgerond, moet u voor de waarde een negatief getal invoeren.

Cluster

Produceert clusters van een puntgegevensverzameling 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 het cluster waartoe het behoort. Retourneert een tabel met relaties tussen punten en clusters. Retourneert ook een samengevoegde tabel met de naam Clusters with cluster geometries. Deze bevat de velden ClusterID, ClusterCenter (puntgeometrie) en PointCount. Het veld PointCount bevat het aantal punten in het cluster.

Retourneert de volgende kolommen:

  • <dataset key column> - de sleutelkolom uit de invoergegevensverzameling.
  • ClusterID - id van het cluster waartoe het punt behoort.
  • Clusters.ClusterPoint - middelpunt voor cluster.
  • Clusters.PointCount - aantal oorspronkelijke punten dat tot het cluster behoort.
  • Alle kolommen behalve de sleutelkolom uit de invoergegevensverzameling, met als prefix de naam van de gegevensverzameling.

Ondersteunt:

  • ScriptEval in load-scripts.

In dit voorbeeld worden luchthavens in de VS geclusterd, waarbij luchthavens die dichterbij zijn dan 50 km tot één cluster behoren:

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

Dissolve

Maakt aangepaste, vereenvoudigde gebieden door grotere gebieden te vormen op basis van de mapping tussen oude gebiedsidentiteiten (of geometrieën) en nieuwe gebiedsidentiteiten. Dit wordt meestal gebruikt voor het maken van aangepaste gebieden die zijn opgebouwd uit kleinere goed gedefinieerde gebieden, zoals postcodegebieden of bestuursgebieden.

Retourneert de volgende kolommen:

  • <dissolveField> - het veld dat is opgegeven als dissolveField in indata
  • DissolvedPolygon - de geometrieën van de nieuwe dissolved gebieden.

Ondersteunt:

  • ScriptEval in load-scripts.

De geometriegegevensverzameling is optioneel. Indien niet opgegeven, behoren de geometrieën beschikbaar te zijn in de gegevensverzameling van de dissolve-definitie.

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

In dit voorbeeld ziet u twee regio's, een voor CA en AZ en een voor 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
Parameters Type Gebruik Beschrijving
dissolveField tekenreeks standaard:<same name as the key field in dissolveDataset> De naam van het veld met identiteiten van de nieuwe gebieden in dissolveDataset.
resolution tekenreeks default:Auto De resulterende gegevensverzameling is vereenvoudigd en de mate van vereenvoudiging wordt bepaald door deze eigenschap. Beschikbare waarden zijn:
  • auto - De bewerking berekent een resolutie op basis van gegevens.
  • autolow - Een resolutie die de helft lager is dan die van de resolutie Auto.
  • autohigh - Een resolutie die het dubbele is van de resolutie Auto.
  • source - Er wordt geen vereenvoudiging uitgevoerd. Merk op dat source moet worden gebruikt indien dissolveDataset dezelfde oude gebieden twee keer in twee verschillende nieuwe gebieden bevat.
areaDatasetKeyField tekenreeks standaard:<key field in areaDataset> De identiteiten van de oorspronkelijke gebieden in areaDataset. Dit wordt alleen gebruikt als areaDataset is opgegeven.
dissolveDataset Gegevensverzameling standaard:<first dataset> De definitie van welk nieuw gebied hoort bij elk oud gebied, met andere woorden een mapping tussen oude en nieuwe gebiedsidentiteiten. Het sleutelveld moet een mapping hebben met de sleutels in areaDataset indien opgegeven. Als geen areaDataset is opgegeven, moeten de geometrieën beschikbaar zijn in deze gegevensverzameling.
areaDataset Gegevensverzameling standaard:<second dataset if any> De gegevensverzameling met geometrieën in het gebied die in aanmerking komen voor dissolve. Dit zou geen kunnen zijn, wat betekent dat de geometrieën beschikbaar moeten zijn in dissolveDataset. De areaDatasetKeyField in deze gegevensverzameling moet gekoppeld zijn aan het sleutelveld in dissolveDataset.
precisie geheel getal standaard:6 Stelt het aantal decimalen in voor het afronden van coördinaten. De standaardwaarde is 6 decimalen, dat overeenkomt met circa 10 cm. Als u niet wilt dat coördinaten worden afgerond, moet u voor de waarde een negatief getal invoeren.

Intersects

Retourneert een tabel met de mapping tussen de sleutel in gegevensverzameling1 en de sleutel in gegevensverzameling2 voor alle objecten die elkaar kruisen. Als beide gegevensverzamelingen polygonen bevatten, wordt het relatieve overlapgebied vergeleken met de gebieden in de respectievelijke gegevensverzameling geretourneerd.

Het is mogelijk om het aantal kruisende geometrieën in de tweede gegevensverzameling die moeten worden toegewezen aan elke geometrie in de eerste gegevensverzameling te beperken door intersectsCount op te geven. Vervolgens worden de meest kruisende 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 gegenereerd voor de relatie tussen de twee geometrieën.
  • <dataset1 key column> - de sleutelkolom uit de invoergegevensverzameling1.
  • <dataset2 key column> - de sleutelkolom uit de invoergegevensverzameling2.
  • <dataset1 name>.RelativeOverlap - de overlap vergeleken met de polygoon in gegevensverzameling1. Wordt alleen geretourneerd als beide gegevensverzamelingen polygonen bevatten. Een aanvraag voor dit veld heeft een ongunstige invloed op de prestaties.
  • <dataset2 name>.RelativeOverlap - de overlap vergeleken met de polygoon in gegevensverzameling2. Wordt alleen geretourneerd als beide gegevensverzamelingen polygonen bevatten. Een aanvraag voor dit veld heeft een ongunstige invloed op de prestaties.
  • Alle kolommen behalve de sleutelkolom uit de invoergegevensverzameling dataset1, met als prefix de naam van de gegevensverzameling.
  • Alle kolommen behalve de sleutelkolom uit de invoergegevensverzameling dataset2, met als prefix de naam van de gegevensverzameling.

Ondersteunt:

  • ScriptEval in load-scripts.

Dit voorbeeld illustreert de berekening van welke staten sommige lijnen doorkruisen:

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
Parameters Type Gebruik Beschrijving
dataset1 Gegevensset standaard:<first dataset> Een gegevensverzameling om te testen welke geometrieën kruisen met geometrieën in de andere gegevensverzameling indien opgegeven of tussen objecten in deze gegevensverzameling indien niet opgegeven. Bij het controleren van snijpunten tussen objecten in één gegevensverzameling worden relaties nooit toegevoegd vanaf een object naar zichzelf. Ondersteunt streaming van deze gegevensverzameling wanneer deze wordt verzonden vanuit het load-script en wanneer dataset2 is gedefinieerd, wat betekent dat grotere tabellen zijn toegestaan.
dataset2 Gegevensset standaard:<second dataset if any> Een gegevensverzameling om te testen welke geometrieën kruisen met geometrieën in de andere gegevensverzameling. Indien niet opgegeven, wordt het snijpunt tussen objecten in dataset1 berekend.
intersectsCount geheel getal standaard:0 Indien groter dan 0, dan wordt maximaal dit aantal kruisende geometrieën in gegevensverzameling 2 geretourneerd per dataset1-geometrie. Alleen de geometrieën die het meest overlappen (grootste overlappende gebied of lengte) worden geretourneerd.
precisie geheel getal standaard:6 Stelt het aantal decimalen in voor het afronden van coördinaten. De standaardwaarde is 6 decimalen, dat overeenkomt met circa 10 cm. Als u niet wilt dat coördinaten worden afgerond, moet u voor de waarde een negatief getal invoeren.

IpLookup

Retourneert locatiegegevens en puntgeometrieën voor IP-addressen 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.
  • <IP-veld adrestabel> - hetzelfde als het IP-veld dat werd opgezocht. Alleen beschikbaar als die niet hetzelfde is als het sleutelveld.
  • IpPoint - Het punt voor het gevonden item.
  • CountryIso2 - De landcode voor het gevonden item.
  • Adm1Code - De code voor het bestuursgebied van het eerste bestuurlijke niveau voor het gevonden item. Houd er rekening mee 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 invoergegevensverzameling, met als prefix de naam van de gegevensverzameling.

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

Best practice is om alleen de IP-kolom naar de bewerking IpLookup te sturen. Voorbeeld waarin enkele IP-adressen worden opgezocht:

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 in dat geval de prestaties om eerst alleen de unieke IP's uit 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 die zijn gemaakt door MaxMind, beschikbaar op MaxMind.

Parameters voor IpLookup
Parameters Type Gebruik Beschrijving
ipField tekenreeks optioneel Het veld met het IP-adres dat moet worden opgezocht. Gebruikt het sleutelveld van de gegevensverzameling indien niet opgegeven.
dataset Gegevensverzameling standaard: Geen. Een gegevensverzameling met IP-adressen die worden opgezocht in de geocoder. Ondersteunt streaming van deze gegevensverzameling wanneer deze wordt verzonden vanuit het load-script, wat betekent dat grotere tabellen zijn toegestaan.
precisie geheel getal standaard:6 Stelt het aantal decimalen in voor het afronden van coördinaten. De standaardwaarde is 6 decimalen, dat overeenkomt met circa 10 cm. Als u niet wilt dat coördinaten worden afgerond, moet u voor de waarde een negatief getal invoeren.

Laden

Laadt de gegevensverzameling en past geen bewerking toe. Dit maakt het mogelijk om alle indelingen te laden die door GeoOperations worden ondersteund. Merk op dat Vereenvoudigen een goed alternatief kan zijn voor Laden als geometrieën veel details bevatten en langzaam worden weergegeven.

Retourneert de volgende kolommen:

  • Alle kolommen van gegevensverzameling.

Ondersteunt:

  • ScriptEval in load-scripts.

In dit voorbeeld worden postcodes uit Zweden geladen:

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 Laden bij uitstek geschikt om geografische geometrieën die zijn geladen uit een database te converteren naar de Sense-geometrie-indeling zodat deze kan worden weergegeven. Het volgende voorbeeld laat zien hoe WKT-gegevens, in dit geval uit de tabel MyWKTData, kunnen worden geconverteerd:

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
Parameters Type Gebruik Beschrijving
dataset Gegevensset standaard:<first dataset> Dataset om te laden. Ondersteunt streaming van deze gegevensverzameling wanneer deze wordt verzonden vanuit het load-script, wat betekent dat grotere tabellen zijn toegestaan.
precisie geheel getal standaard:6 Stelt het aantal decimalen in voor het afronden van coördinaten. De standaardwaarde is 6 decimalen, dat overeenkomt met circa 10 cm. Als u niet wilt dat coördinaten worden afgerond, moet u voor de waarde een negatief getal invoeren.

PointToAddressLookup

Retourneert het dichtstbijzijnde adres voor punten in de lijst, ook bekend als reverse geocodering. Deze bewerking vereist een speciale licentie. Punten die dicht bij straten liggen krijgen straatadressen, anders worden treffers op postcode of gemeentelijk niveau geretourneerd. Voor punten die te ver weg liggen worden geen gegevens geretourneerd.

Retourneert de volgende kolommen:

  • <dataset key column> - de sleutelkolom uit de invoergegevensverzameling.
  • Address - het gevonden adres, in de standaardadresindeling 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 het bestuursdistrict op gemeentelijk niveau voor het gevonden item.
  • Adm1 - de naam of afgekorte naam voor het bestuursdistrict van het eerste bestuurlijke niveau (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 de gegevensverzameling, met als prefix de naam van de gegevensverzameling.

Houd er rekening mee dat de geretourneerde velden mogelijk leeg zijn als ze niet van toepassing zijn of als er geen gegevens beschikbaar zijn.

Voorbeeld waarin adressen voor een aantal punten worden opgehaald:

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
Parameters Type Gebruik Beschrijving
language tekenreeks standaard: Een landcode van twee letters voor de voorkeurstaal voor het adres in het antwoord. Als het adres niet beschikbaar is in de gevraagde taal, wordt dit geretourneerd in een standaardtaal voor de locatie.
dataset Gegevensverzameling standaard: Geen. Een gegevensverzameling met punten die worden opgezocht in de geocoder. Ondersteunt streaming van deze gegevensverzameling wanneer deze wordt verzonden vanuit het load-script, wat betekent dat grotere tabellen zijn toegestaan.
precisie geheel getal standaard:6 Stelt het aantal decimalen in voor het afronden van coördinaten. De standaardwaarde is 6 decimalen, dat overeenkomt met circa 10 cm. Als u niet wilt dat coördinaten worden afgerond, moet u voor de waarde een negatief getal invoeren.

Routes

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

Merk op dat de oorsprong de geometriekolom in de gegevensverzameling is. De bestemmingskolom wordt gespecificeerd in bewerkingsparameters, aangezien gegevensverzamelingen slechts één geometriekolom kennen.

Als u bird (hemelsbreed) als vervoertype gebruikt, worden grote cirkelbogen gegenereerd tussen oorsprong en bestemming.

Retourneert de volgende kolommen:

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

Ondersteunt:

  • ScriptEval in load-scripts.
  • ScriptEvalStr in diagramscripts voor het ophalen van de route.
  • ScriptEval in diagramscripts voor het ophalen van de afstand of duur.

Dit voorbeeld illustreert de berekening van routes tussen punten in een gegevensverzameling:

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 voorbeeld illustreert de berekening van routes rechtsteeks in een lijnlaag. De bewerking wordt aangeroepen voor de selectie telkens wanneer de selectie verandert. Normaal gesproken is er een berekeningsvoorwaarde die waar is als er maar een paar punten zijn geselecteerd (anders is het beter om de routes in het load-script te berekenen). Dit moet worden opgenomen in het load-script 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 worden ingesteld op Lijngeometrie, voert u het volgende in om de routes vanaf 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
Parameters Type Gebruik Beschrijving
dataset Gegevensverzameling standaard: Geen. Een gegevensverzameling met oorsprongen en bestemmingen voor de te berekenen routes. De oorsprongen moeten zich in de geometrie van de gegevensverzameling bevinden. Ondersteunt streaming van deze gegevensverzameling wanneer deze wordt verzonden vanuit het load-script, wat betekent dat grotere tabellen zijn toegestaan.
criteria tekenreeks standaard:fastest Kies tussen fastest (snelste) of shortest (kortste) route die moet worden berekend.
transportation tekenreeks standaard:car De vervoermodus, hetzij car, truck, bike, pedestrian of bird (vogelvlucht van 10 m/s).
destField tekenreeks standaard: Geen. Het veld in de gegevensverzameling dat de bestemming specificeert. Merk op dat de oorsprong de geometriekolom in de gegevensverzameling is.
geometryType tekenreeks default: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 een kolom voor de geometrie toegevoegd.
suffix tekenreeks standaard: Geen. Voor gevorderde gebruikers. De opgegeven tekenreeks wordt toegevoegd aan het einde van alle id's. Dit is een handige manier om meer informatie op te geven voor 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 suffix worden alle items opgegeven als steden in Zweden:
,SE:city
Raadpleeg de Location Service Guide voor meer informatie over de te gebruiken syntaxis.
precisie geheel getal standaard:6 Stelt het aantal decimalen in voor het afronden van coördinaten. De standaardwaarde is 6 decimalen, dat overeenkomt met circa 10 cm. Als u niet wilt dat coördinaten worden afgerond, moet u voor de waarde een negatief getal invoeren.

Simplify

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

Het niveau van vereenvoudiging wordt automatisch berekend op basis van gebied, aantal objecten en de grootte van objecten. Vervolgens kan dit worden aangepast naar een hogere of lagere resolutie met de parameter voor resolutie.

Vereenvoudiging van het gebied wordt uitgevoerd met een algoritme dat topologieën verwerkt, hiaten verwijdert en eilanden samenvoegt.

Lijnvereenvoudiging wordt uitgevoerd met behulp van een algoritme voor breekpuntreductie.

Overlappingen van polygonen worden verwijderd. De uitvoer zal geen overlappende polygonen bevatten.

Retourneert de volgende kolommen:

  • <dataset key column> - de sleutelkolom uit de invoer dataset1.
  • Simplified_<geometry column name> - vereenvoudigde versie van de oorspronkelijke geometrieën.
  • Alle kolommen behalve de sleutelkolom uit de gegevensverzameling, met als prefix de naam van de gegevensverzameling.

Ondersteunt:

  • ScriptEval in load-scripts.

In dit voorbeeld worden vereenvoudigde versies van staten in de VS geladen:

Load * Extension GeoOperations.ScriptEval(' SELECT LocationDbId, Simplified_LocationPolygon FROM Simplify() DATASOURCE states LOCATIONSERVICE type="State", country="us" ');
Parameters voor Simplify
Parameters Type Gebruik Beschrijving
resolution tekenreeks default:Auto De resulterende gegevensverzameling is vereenvoudigd en de mate van vereenvoudiging wordt bepaald door deze eigenschap. Beschikbare waarden zijn:
  • Auto - De bewerking berekent een resolutie op basis van gegevens.
  • AutoLow - Een resolutie die de helft lager is dan die van de resolutie Auto.
  • AutoHigh - Een resolutie die het dubbele is van de resolutie Auto.
dataset Gegevensset standaard:<first dataset> De gegevensverzameling met geometrieën die moeten worden vereenvoudigd.
precisie geheel getal standaard:6 Stelt het aantal decimalen in voor het afronden van coördinaten. De standaardwaarde is 6 decimalen, dat overeenkomt met circa 10 cm. Als u niet wilt dat coördinaten worden afgerond, moet u voor de waarde een negatief getal invoeren.

TravelAreas

Berekent reistijd ISO-gebieden. Alle locaties binnen het geretourneerde gebied zijn binnen een bepaalde tijd te bereiken of liggen binnen een bepaalde afstand via het wegennet. Retourneert een tabel met id, reisgebiedgeometrie, middelpunt, kosten, kosteneenheid en status (OK of mislukt).

Als u "bird" (hemelsbreed) gebruikt als vervoertype, worden geografisch juiste cirkels gegenereerd rond de oorsprong.

Retourneert de volgende kolommen:

  • <dataset key column> - de sleutelkolom uit de invoergegevensverzameling.
  • TravelArea - de polygoongeometrie die het reisgebied definieert.
  • Cost - de kosten zoals gespecificeerd in costValue of costField.
  • CostUnit - de kosteneenheid zoals gespecificeerd in costUnit.
  • Status - de geretourneerde status is "OK" of "mislukt:" gevolgd door een foutmelding.
  • Alle kolommen behalve de sleutelkolom uit de invoergegevensverzameling, met als prefix de naam van de gegevensverzameling.

Ondersteunt:

  • ScriptEval in load-scripts.
  • ScriptEvalStr in diagramscripts voor het ophalen van de reisgebiedgeometrie.
  • ScriptEval in diagramscripts voor het ophalen van de kosten.

In dit voorbeeld van een load-script worden reisgebieden in Miami en Orlando met 10 minuten reistijd gegenereerd 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);

In dit voorbeeld van een load-script worden reisgebieden in Miami en Orlando met 10 minuten reistijd gegenereerd op basis 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 voorbeeld illustreert de berekening van reisgebieden rond punten direct in een Gebiedslaag. De bewerking wordt aangeroepen voor de selectie telkens wanneer de selectie verandert. Dit moet worden opgenomen in het load-script 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

Voer het volgende in de eigenschap Location in:

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

Parameters voor TravelAreas
Parameters Type Gebruik Beschrijving
dataset Gegevensset standaard:<first dataset> Een gegevensverzameling met oorsprongen en optioneel kosten voor de berekeningen van het reisgebied. Ondersteunt streaming van deze gegevensverzameling wanneer deze wordt verzonden vanuit het load-script, wat betekent dat grotere tabellen zijn toegestaan.
costValue getal standaard: Geen. De kosten op 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 mogelijk maakt, is om in plaats daarvan costField op te geven.
costField tekenreeks standaard: Geen. Een veld in de gegevensverzameling dat de kosten specificeert. Dit wordt alleen gebruikt als costValue leeg is.
costUnit tekenreeks standaard:seconden Moet een van de volgende zijn: seconden, minuten, uren, meters, yards, kilometers of mijlen. Bij gebruik van een tijdseenheid wordt het binnen die tijd bereikte gebied berekend en bij gebruik van een lengte-eenheid het gebied met een kortere reisafstand dan gespecificeerd.
transportation tekenreeks standaard:car De vervoermodus, hetzij car, truck, bike, pedestrian of bird (vogelvlucht van 10 m/s).
precisie geheel getal standaard:6 Stelt het aantal decimalen in voor het afronden van coördinaten. De standaardwaarde is 6 decimalen, dat overeenkomt met circa 10 cm. Als u niet wilt dat coördinaten worden afgerond, moet u voor de waarde een negatief getal invoeren.

Within

Retourneert de relaties tussen twee gegevensverzamelingen waarbij een geometrie in de ene gegevensverzameling (ingesloten) volledig binnen het gebied in de andere gegevensverzameling (insluitend) ligt. Retourneert een tabel met de mapping tussen de sleutel in de ingesloten gegevensverzameling en de sleutel in de insluitende gegevensverzameling voor alle gevonden relaties.

Meestal gebruikt om te bepalen in welke gebieden de gegevens zich bevinden; bijvoorbeeld testen van gps-positie om vast te stellen in welk bestuurlijk gebied de gegevens zich bevinden. Dit is vergelijkbaar met reverse geocodering.

Retourneert de volgende kolommen:

  • <enclosed name>_<enclosing name>_RelationId - een sleutel gegenereerd voor de relatie tussen de twee geometrieën.
  • <enclosed key column> - de sleutelkolom uit de invoergegevensverzameling1.
  • <enclosing key column> - de sleutelkolom uit de invoergegevensverzameling2.
  • Alle kolommen behalve de sleutelkolom uit de ingesloten gegevensverzameling (enclosed), met als prefix de naam van de gegevensverzameling.
  • Alle kolommen behalve de sleutelkolom uit de ingesloten gegevensverzameling (enclosing) met als prefix de naam van de gegevensverzameling.

Ondersteunt:

  • ScriptEval in load-scripts.

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

Dit is een voorbeeld van een load-script 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
Parameters Type Gebruik Beschrijving
enclosed Gegevensset standaard:<first dataset> Een gegevensverzameling met geometrieën om te testen voor welke gebieden ze zijn ingesloten. Ondersteunt streaming van deze gegevensverzameling wanneer deze wordt verzonden vanuit het load-script, wat betekent dat grotere tabellen zijn toegestaan.
enclosing Gegevensset standaard:<second dataset> Een gegevensverzameling met gebiedsgeometrieën om te testen welke geometrieën ze insluiten. Ondersteunt streaming van deze gegevensverzameling wanneer deze wordt verzonden vanuit het load-script, wat betekent dat grotere tabellen zijn toegestaan.
precisie geheel getal standaard:6 Stelt het aantal decimalen in voor het afronden van coördinaten. De standaardwaarde is 6 decimalen, dat overeenkomt met circa 10 cm. Als u niet wilt dat coördinaten worden afgerond, moet u voor de waarde een negatief getal invoeren.
 

Was deze pagina nuttig?

Als u problemen ervaart op deze pagina of de inhoud onjuist is – een typfout, een ontbrekende stap of een technische fout – laat het ons weten zodat we dit kunnen verbeteren!