Vai al contenuto principale Passa a contenuto complementare

Operazione

AddressPointLookup

Restituisce geometrie a punti per gli indirizzi in una tabella, ovvero una geocodifica. Specificare una stringa indirizzo nella proprietà Cerca testo o parti strutturate nelle proprietà corrispondenti, come Country, Street, ecc. Sono consentite anche le combinazioni. Questa operazione richiede una licenza speciale. Gli indirizzi che non è possibile individuare per qualsiasi motivo non vengono restituiti nel risultato.

La funzionalità offerta da Qlik Geocoding (tramite AddressPointLookup e PointToAddressLookup) è diversa da altre funzioni di ricerca di località. Qlik Geocoding permette di effettuare ricerche a livello di indirizzo, mentre le normali ricerche di località possono essere precise solo a livello di codice postale.

Per iniziare a usare il Geocoding, usare il modello a cui si fa riferimento in Configurazione di Qlik Geocoding (solo in lingua inglese).

Nota informatica Per ottenere i migliori risultati, favorire i dati specifici e omettere i dati generali quando possibile. Ad esempio, se si dispone di un codice postale e della città postale e si è sicuri che il codice postale sia corretto, allora è meglio non specificare la città postale.

Gran parte dei parametri sono forniti in due versioni, una che specifica il valore effettivo, come country="SWE" e una che specifica il nome di un campo da cui recuperare il valore effettivo, come countryField="CountryIso2".

Nota informatica Per geocodificare gli indirizzi in inglese o Pinyin in Cina, il parametro Country deve essere impostato su "CHN".

Restituisce le seguenti colonne:

  • <dataset key column> - La colonna chiave dal set di dati di input.
  • Address - L'indirizzo trovato, formattato secondo gli standard di indirizzo del Paese.
  • Geometry - Il punto per l'elemento trovato.
  • HouseNumber - Il numero civico per l'elemento trovato.
  • Street - La via per l'elemento trovato.
  • PostalCode - Il codice postale per l'elemento trovato.
  • City - Il nome della divisione amministrativa a livello di città per l'elemento trovato.
  • Adm1 - Il nome o il nome abbreviato della divisione amministrativa di primo livello (stato) per l'elemento trovato.
  • CountryIso2 - Il codice del paese per l'elemento trovato.
  • Corrispondenza - Un valore tra 0 e 1 che mostra il livello di corrispondenza. Un valore di 1 indica una corrispondenza perfetta.
  • Tutte le colonne tranne la colonna chiave dal set di dati, con il nome del set di dati come prefisso.

I campi restituiti possono essere vuoti laddove non applicabile o laddove i dati non sono disponibili.

Supporta:

  • ScriptEval negli script di caricamento.

Esempio che geocodifica alcuni indirizzi svedesi in cui ciascun elemento si trova nel proprio campo:

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

Questo esempio mostra la geocodifica in uno stile di testo libero:

[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);
Parametri per AddressPointLookup
Parametro Tipo Utilizzare Descrizione
searchText stringa opzionale Una stringa di testo da ricercare. Può corrispondere a indirizzi come: "1600 Pennsylvania Ave, Washington DC, USA" o a indirizzi incompleti combinati con dati in altri campi, come "1117 Washington Ave", con il campo City impostato su "Philadelphia" e Country impostato su "USA".
searchTextField stringa opzionale Se searchText non viene specificato, questo parametro può essere utilizzato per specificare un campo da cui è necessario ricavare le impostazioni.
country stringa opzionale Una stringa con codici ISO a tre lettere. È possibile specificare più Paesi separati da virgole, come: "SWE,NOR,FIN". Per geocodificare gli indirizzi in inglese o Pinyin in Cina specificatamente, questo parametro deve essere impostato su "CHN".
countryField stringa opzionale Se il campo country non è specificato, questo parametro può essere utilizzato per specificare un campo contenente il nome del Paese o i relativi codici ISO da due o tre lettere. Notare che a differenza degli altri parametri, il formato previsto dei dati specificati da country e countryField non è lo stesso. Per il parametro country è possibile aggiungere più paesi, ma solo nel formato ISO a tre lettere, mentre countryField consente di utilizzare anche altri formati per il Paese.
state stringa opzionale Nome o codice dello Stato. Per gran parte dei Paesi, lo stato non fa parte dell'indirizzo.
stateField stringa opzionale Se non viene specificato il valore state, questo parametro può essere utilizzato per specificare un campo da cui è necessario ricavare le impostazioni.
città stringa opzionale Nome città, municipalità o codice postale.
cityField stringa opzionale Se non viene specificato il valore city, questo parametro può essere utilizzato per specificare un campo da cui è necessario ricavare le impostazioni.
postalCode stringa opzionale Codice postale.
postalCodeField stringa opzionale Se non viene specificato il valore postalCode, questo parametro può essere utilizzato per specificare un campo da cui è necessario ricavare le impostazioni.
strada stringa opzionale Nome strada. Invece di specificare la strada e il numero di casa in parametri o campi separati, è consentito specificarli entrambi insieme, separati da uno spazio.
streetField stringa opzionale Se non viene specificato il valore street, questo parametro può essere utilizzato per specificare un campo da cui è necessario ricavare le impostazioni.
houseNumber stringa opzionale Numero di casa.
houseNumberField stringa opzionale Se non viene specificato il valore houseNumber, questo parametro può essere utilizzato per specificare un campo da cui è necessario ricavare le impostazioni.
matchThreshold reale predefinito:0.5 Restituisce solo il risultato con una migliore corrispondenza rispetto a questo. Aumenta questo valore se vengono restituiti troppi falsi risultati.
lingua stringa predefinito: Nessuno. Un codice lingua di due lettere per la lingua preferenziale per l'indirizzo nella risposta. Se l'indirizzo non è disponibile nella lingua richiesta, viene restituito in una lingua predefinita per la posizione.
set di dati Set di dati predefinito: Nessuno. Un set di dati con indirizzi che verranno ricercati nel geocodificatore. Supporta lo streaming di questo set di dati quando inviato dallo script di caricamento, in modo da consentire tabelle di dimensioni maggiori.
precisione numero intero predefinito:6 Imposta il numero di decimali a cui arrotondare nelle coordinate. Il valore predefinito è 6 decimali, preciso a circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore a un numero negativo.

Creazione di contenitori

Genera contenitori rettangolari o esagonali per un set di dati di punti. Si tratta di un modo per aggregare i dati di punti, in modo che una panoramica dei dati possa essere visualizzata efficientemente.

Restituisce le seguenti colonne:

  • <dataset key column> - La colonna chiave dal set di dati di input.
  • BinId - Identità per il contenitore.
  • BinTable.BinPolygon - Il poligono per il contenitore.
  • BinTable.CenterPoint - Punto al centro del contenitore.
  • Tutte le colonne tranne la colonna chiave dal set di dati, con il nome del set di dati come prefisso.

Supporta:

  • ScriptEval negli script di caricamento.

Esempio che carica i contenitori esagonali dagli aeroporti USA:

Load * Extension GeoOperations.ScriptEval(' Binning(type="hexagonal", gridSize="1") DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="us" ');
Parametri per il partizionamento
Parametro Tipo Utilizzare Descrizione
tipo stringa predefinito:rectangular Definisce se è necessario generare contenitori rettangolari o esagonali.
gridSize reale predefinito: Nessuno. L'altezza di un singolo contenitore in gradi. Un grado è pari a circa 10000 m.
gridWidthHeightRatio reale predefinito:1.5 Il rapporto tra larghezza e altezza dei contenitori. I contenitori quadrati sono in genere ottimali, ma ciò può variare con la latitudine. La formula per un rapporto ottimale larghezza/altezza è 1/cos(latitudine), per esempio 1 all'equatore, 1.15 a una latitudine +-30 gradi e 2 a una latitudine +-60 gradi. Spesso è consigliabile visualizzare i dati nei contenitori nella proiezione adattiva piuttosto che nella proiezione Mercatore.
set di dati Set di dati predefinito: Nessuno. Il set di dati con geometrie a punti per il quale generare contenitori. Supporta lo streaming di questo set di dati quando inviato dallo script di caricamento, in modo da consentire tabelle di dimensioni maggiori.
precisione numero intero predefinito:6 Imposta il numero di decimali a cui arrotondare nelle coordinate. Il valore predefinito è 6 decimali, preciso a circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore a un numero negativo.

Più vicino

Restituisce le relazioni e le distanze tra oggetti in un set di dati e i più vicini n oggetti in un altro, se qualcuno è più vicino rispetto alla massima distanza. Può anche essere calcolato il costo lungo le strade e, in quel caso, è possibile utilizzare in via opzionale il tempo di viaggio. Questa operazione risulta utile in molti casi, non solo per ottenere le relazioni con il più vicino, ma anche per ottenere matrici di distanza tra un set di punti.

Restituisce le seguenti colonne:

  • <dataset1 name>_<dataset2 name>_RelationId - Una chiave generata per la relazione tra le due geometrie.
  • <dataset1 key column> - La colonna chiave dal dataset1 input.
  • <dataset2 key column> - La colonna chiave dal dataset2 input.
  • Distance - La distanza nell'unità specificata in costUnit.
  • Status - Lo stato restituito è "ok" o "failed:" seguito da un messaggio di errore.
  • LowResLine - Una versione a bassa risoluzione della linea del percorso, disponibile solo per i tipi di distanza non bird.
  • Tutte le colonne tranne la colonna chiave dal set di dati dataset1 di input, con il nome del set di dati come prefisso.
  • Tutte le colonne tranne la colonna chiave dal set di dati dataset2 di input, con il nome del set di dati come prefisso.

Supporta:

  • ScriptEval negli script di caricamento.

Questo esempio individua gli aeroporti più vicini ai punti in una tabella:

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);
Parametri per Più vicino
Parametro Tipo Utilizzare Descrizione
distanza reale predefinito: Nessuno. Distanza massima dall'unità specificata in unità Costo. Gli elementi più distanti di così vengono ignorati.
costUnit stringa predefinito:meters Deve essere compresa tra metri, iarde, chilometri, miglia, secondi, minuti e ore. L'uso di unità di tempo implica che il tempo di viaggio è usato come unità di costo e lunghezza piuttosto che la distanza. Le unità di tempo non sono consentite per il tipo di distanza Bird.
distanceType reale predefinito:Bird Decide come vengono misurate le distanze. Sono consentiti i seguenti valori:
  • Bird - Misura le distanze dirette (tramite il volo del corvo) tra gli oggetti.
  • Car - misura lungo le strade con restrizioni auto Supportato solo per i set di dati punti.
  • Bike - misura lungo le strade con restrizioni bici. Supportato solo per i set di dati punti.
  • Pedestrian - misura lungo le strade con restrizioni pedone. Supportato solo per i set di dati punti.
  • Truck - misura lungo le strade con restrizioni camion. Supportato solo per i set di dati punti.
closestCount reale predefinito:1 Numero di oggetti nel secondo set di dati da associare a un oggetto nel primo set di dati. Un valore di 1 significa solo il più vicino, 2 significa i due più vicini e così via.
dataset1 Set di dati predefinito:<primo set di dati> Gli oggetti da controllare per la vicinanza agli oggetti nel set di dati 2 se specificato, altrimenti agli oggetti in sé. Quando si controlla la vicinanza tra gli oggetti in un set di dati singolo, le relazioni non vengono mai aggiunte da un oggetto a se stesso. Supporta lo streaming di questo set di dati se inviato dallo script di caricamento e definito il dataset2, in modo da consentire tabelle di maggiori dimensioni.
dataset2 Set di dati predefinito:<secondo set di dati se disponibile> Oggetti da correlare agli oggetti nel dataset1.
precisione numero intero predefinito:6 Imposta il numero di decimali a cui arrotondare nelle coordinate. Il valore predefinito è 6 decimali, preciso a circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore a un numero negativo.

Cluster

Produce cluster da un set di dati punto in base alla vicinanza geografica tra i punti. La generazione di cluster è controllata dal parametro distance che definisce quanto lontano può trovarsi un punto dal cluster a cui appartiene. Restituisce una tabella con relazioni tra punti e cluster. Restituisce anche una tabella unita denominata Cluster con geometrie cluster. Contiene i campi ClusterID, ClusterCenter (geometria punti) e PointCount. Il campo conteggio contiene il numero di punti nel cluster.

Restituisce le seguenti colonne:

  • <dataset key column> - La colonna chiave dal set di dati di input.
  • ClusterID - Id del cluster a cui appartiene il punto.
  • Clusters.ClusterPoint - Punto centrale per il cluster.
  • Clusters.PointCount - Numero di punti originali appartenenti al cluster.
  • Tutte le colonne tranne la colonna chiave dal set di dati di input, con il nome del set di dati come prefisso.

Supporta:

  • ScriptEval negli script di caricamento.

Questo esempio crea un cluster di aeroporti negli Stati Uniti, in modo che gli aeroporti più vicini di 50 km appartengano a un unico cluster:

MyClusteredAirports: Load * Extension GeoOperations.ScriptEval(' Cluster(distance="50000") DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="us" ');
Parametri per cluster
Parametro Tipo Utilizzare Descrizione
distanza reale predefinito: Nessuno. La distanza tra un punto e il relativo cluster non può essere superiore a questa distanza in metri.
set di dati Set di dati predefinito: Nessuno. Un set di dati con punti nel cluster.
precisione numero intero predefinito:6 Imposta il numero di decimali a cui arrotondare nelle coordinate. Il valore predefinito è 6 decimali, preciso a circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore a un numero negativo.

Scomponi

Scompone e semplifica le aree per formare aree più grandi in base alla mappatura tra le vecchie identità (o geometrie) delle aree e le identità delle nuove aree. Viene in genere utilizzato per creare aree personalizzate generate da aree più piccole ben definite, come le aree postali o le aree amministrative.

Restituisce le seguenti colonne:

  • <dissolveField> - Il campo specificato come dissolveField in indata.
  • DissolvedPolygon - Le geometrie delle nuove aree sciolte.

Supporta:

  • ScriptEval negli script di caricamento.

Il set di dati geometria è opzionale. Se non viene fornito, le geometrie devono essere disponibili nel set di dati di definizione di scomposizione.

Notare che le sovrapposizioni di poligoni vengono rimosse in tutte le risoluzioni tranne Origine.

Questo esempio crea due regioni, una composta da CA e AZ e una composta da WA e 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);
Parametri per Scomponi
Parametro Tipo Utilizzare Descrizione
dissolveField stringa predefinito:<stesso nome del campo chiave in dissolveDataset> Il nome del campo con identità delle nuove aree in dissolveDataset.
risoluzione stringa predefinito:Auto Il set di dati risultante è semplificato e il grado di semplificazione è controllato da questa proprietà. I valori disponibili sono:
  • auto - L'operazione calcola una risoluzione basata sui dati.
  • autolow - Una risoluzione che è inferiore (metà) rispetto alla Risoluzione automatica.
  • autohigh - Una risoluzione che è superiore (doppia) rispetto alla Risoluzione automatica.
  • source - Non viene eseguita alcuna semplificazione. Notare che se dissolveDataset contiene le stesse vecchie aree due volte in due nuove aree diverse, è necessario utilizzare source.
areaDatasetKeyField stringa predefinito:<campo chiave in areaDataset> Le identità delle aree originali in areaDataset. Utilizzato solo se viene specificato areaDataset.
dissolveDataset Set di dati predefinito:<primo set di dati> La definizione di a quale nuova area appartiene ciascuna vecchia area, p. es. una mappatura tra le identità delle vecchie e delle nuove aree. Il campo chiave deve essere mappato alle chiavi in areaDataset se specificato. Se non viene fornito alcun areaDataset, le geometrie devono essere disponibili in questo set di dati.
areaDataset Set di dati predefinito:<secondo set di dati se disponibile> Il set di dati con le aree geometriche da scomporre. Potrebbe corrispondere a nessuno, il che significa che le geometrie devono essere disponibili in dissolveDataset. Il valore areaDatasetKeyField in questa serie di dati deve essere collegato al campo chiave in dissolveDataset.
precisione numero intero predefinito:6 Imposta il numero di decimali a cui arrotondare nelle coordinate. Il valore predefinito è 6 decimali, preciso a circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore a un numero negativo.

Interseca

Restituisce una tabella che mappa tra la chiave nel set di dati 1 e la chiave nel set di dati 2 per tutti gli oggetti che si intersecano. Se entrambi i set di dati contengono poligoni, viene restituita l'area di sovrapposizione relativa alle aree nel rispettivo set di dati.

È possibile limitare il numero di geometrie intersecanti nel secondo set di dati che dovrebbero essere mappate a ogni geometria nel primo set di dati, specificando intersectsCount. Dopodiché, vengono restituite in ordine le geometrie con più intersezioni. L'operazione è simmetrica se non viene specificato intersectsCount.

Restituisce le seguenti colonne:

  • <dataset1 name>_<dataset2 name>_RelationId - Una chiave generata per la relazione tra le due geometrie.
  • <dataset1 key column> - La colonna chiave dal dataset1 input.
  • <dataset2 key column> - La colonna chiave dal dataset2 input.
  • <dataset1 name>.RelativeOverlap - La sovrapposizione rispetto al poligono in dataset1. Restituito solo se entrambi i set di dati contengono poligoni. È presente una penalità alle prestazioni per aver richiesto questo campo.
  • <dataset2 name>.RelativeOverlap - La sovrapposizione rispetto al poligono in dataset2. Restituito solo se entrambi i set di dati contengono poligoni. È presente una penalità alle prestazioni per aver richiesto questo campo.
  • Tutte le colonne tranne la colonna chiave dal set di dati dataset1 di input, con il nome del set di dati come prefisso.
  • Tutte le colonne tranne la colonna chiave dal set di dati dataset2 di input, con il nome del set di dati come prefisso.

Supporta:

  • ScriptEval negli script di caricamento.

Questo esempio calcola quali stati intersecano alcune linee:

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);
Parametri per intersezioni
Parametro Tipo Utilizzare Descrizione
dataset1 Set di dati predefinito:<primo set di dati> Un set di dati con geometrie per testare quali intersecano le geometrie nell'altro set di dati se specificato, o tra gli oggetti in questo set di dati in caso contrario. Quando si controlla l'intersezione tra oggetti in un singolo set di dati, le relazioni non vengono mai aggiunte da un oggetto a esso stesso. Supporta lo streaming di questo set di dati quando inviato dallo script di caricamento e quando viene definito il dataset2, in modo da consentire tabelle di dimensioni maggiori.
dataset2 Set di dati predefinito:<secondo set di dati se disponibile> Un set di dati con geometrie per testare quali intersecano le geometrie nell'altro set di dati. Se non specificata, viene calcolata l'intersezione tra gli oggetti in dataset1.
intersectsCount numero intero predefinito:0 Se superiore a 0, viene restituito al massimo tale numero di geometrie intersecanti in dataset2 per geometria dataset1. Vengono restituite solo quelle con la massima intersezione (maggiore area o lunghezza in sovrapposizione).
precisione numero intero predefinito:6 Imposta il numero di decimali a cui arrotondare nelle coordinate. Il valore predefinito è 6 decimali, preciso a circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore a un numero negativo.

IpLookup

Restituisce informazioni di posizione e geometrie a punti per gli indirizzi IP in una tabella. Ciò risulta utile al momento di analizzare i dati di accesso ai servizi web. La tabella restituita contiene i seguenti campi:
  • Key field - Equivale al campo chiave per la tabella nome.
  • <Address Table Ip Field> - Equivale al campo IP ricercato. Disponibile solo se non corrisponde al campo chiave.
  • IpPoint - Il punto per l'elemento trovato.
  • CountryIso2 - Il codice del Paese per l'elemento trovato.
  • Adm1Code - Il codice per l'area amministrativa di primo livello per l'elemento trovato. Notare che questo codice non è sempre compatibile con il codice restituito dal servizio posizione.
  • City - La città per l'elemento trovato.
  • Tutte le colonne tranne la colonna chiave dal set di dati di input, con il nome del set di dati come prefisso.

La geolocalizzazione IP è intrinsecamente imprecisa. Per molti indirizzi IP è possibile indicare una città, mentre per altri è possibile risolvere solo il Paese.

La pratica consigliata consiste nell'inviare solo la colonna Ip all'operazione IpLookup. Esempio che ricerca alcuni indirizzi IP:

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

È comune che lo stesso IP venga ripetuto in molti righe. Migliora quindi le prestazioni per filtrare per prima cosa solo gli IP univoci, come in questo esempio:

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;

Il prodotto include i dati GeoLite2 creati da MaxMind, disponibili da MaxMind.

Parametri per IpLookup
Parametro Tipo Utilizzare Descrizione
ipField stringa opzionale Il campo con l'indirizzo IP da ricercare. Utilizza il campo chiave del set di dati se non specificato.
set di dati Set di dati predefinito: Nessuno. Un set di dati con indirizzi IP che verranno ricercati nel geocodificatore. Supporta lo streaming di questo set di dati quando inviato dallo script di caricamento, in modo da consentire tabelle di dimensioni maggiori.
precisione numero intero predefinito:6 Imposta il numero di decimali a cui arrotondare nelle coordinate. Il valore predefinito è 6 decimali, preciso a circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore a un numero negativo.

Carica

Carica il set di dati senza applicare alcuna operazione. Ciò rende possibile caricare tutti i formati supportati da GeoOperations. Tenere presente che Simplify può essere una buona alternativa a Load se le geometrie risultano dettagliate e lente da visualizzare.

Restituisce le seguenti colonne:

  • Tutte le colonne da dataset.

Supporta:

  • ScriptEval negli script di caricamento.

Esempio che carica codici postali dalla Svezia:

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

Dato che WKT è supportato come formato geometria per i dati in INTABLE, l'operazione Load è perfetta per convertire le geometrie geografiche caricate da un database nel formato geometrico Sense in modo da poterle visualizzare. L'esempio seguente mostra come convertire i dati WKT, in questo caso dalla tabella 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);
Parametri per Load
Parametro Tipo Utilizzare Descrizione
set di dati Set di dati predefinito:<primo set di dati> Set di dati da caricare. Supporta lo streaming di questo set di dati quando inviato dallo script di caricamento, in modo da consentire tabelle di dimensioni maggiori.
precisione numero intero predefinito:6 Imposta il numero di decimali a cui arrotondare nelle coordinate. Il valore predefinito è 6 decimali, preciso a circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore a un numero negativo.

PointToAddressLookup

Restituisce l'indirizzo più vicino per i punti nell'elenco, noto anche come geocodifica inversa. Questa operazione richiede una licenza speciale. I punti vicini alle strade otterranno indirizzi a livello di strada, altrimenti ricadranno nell'area postale di ritorno o al livello di città. Per i punti troppo lontani, non viene restituito alcun dato.

Restituisce le seguenti colonne:

  • <dataset key column> - La colonna chiave dal set di dati di input.
  • Address - L'indirizzo trovato, formattato secondo gli standard di indirizzo del Paese.
  • Geometry - Il punto per l'elemento trovato.
  • HouseNumber - Il numero civico per l'elemento trovato.
  • Street - La via per l'elemento trovato.
  • PostalCode - Il codice postale per l'elemento trovato.
  • City - Il nome della divisione amministrativa a livello di città per l'elemento trovato.
  • Adm1 - Il nome o il nome abbreviato della divisione amministrativa di primo livello (stato) per l'elemento trovato.
  • CountryIso2 - Il codice del Paese per l'elemento trovato.
  • Distance - Distanza in metri all'indirizzo trovato.
  • Tutte le colonne tranne la colonna chiave dal set di dati, con il nome del set di dati come prefisso.

Notare che i campi restituiti possono essere vuoti laddove non applicabile o laddove i dati non sono disponibili.

Esempio che ottiene gli indirizzi per alcuni punti:

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);
Parametri per PointToAddressLookup
Parametro Tipo Utilizzare Descrizione
lingua stringa predefinito: Un codice lingua di due lettere per la lingua preferenziale per l'indirizzo nella risposta. Se l'indirizzo non è disponibile nella lingua richiesta, viene restituito in una lingua predefinita per la posizione.
set di dati Set di dati predefinito: Nessuno. Un set di dati con punti che verranno ricercati nel geocodificatore. Supporta lo streaming di questo set di dati quando inviato dallo script di caricamento, in modo da consentire tabelle di dimensioni maggiori.
precisione numero intero predefinito:6 Imposta il numero di decimali a cui arrotondare nelle coordinate. Il valore predefinito è 6 decimali, preciso a circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore a un numero negativo.

Percorsi

Calcola i percorsi, inclusa la lunghezza e la durata, tra due posizioni in una tabella.

Notare che l'origine corrisponde alla colonna geometria nel set di dati. La colonna destinazione viene specificata nei parametri dell'operazione, dato che i set di dati rilevano una sola colonna di geometria.

Se si utilizza bird come tipo di trasporto, vengono generati ampi archi circolari tra le origini e le destinazioni.

Restituisce le seguenti colonne:

  • <dataset key column> - La colonna chiave dal set di dati di input.
  • Distance - La distanza del percorso in metri.
  • Duration - Il tempo di percorrenza stimato in secondi.
  • Status - Lo stato restituito è "ok" o "failed:" seguito da un messaggio di errore.
  • LowResLine - Una versione a bassa risoluzione della linea del percorso.
  • Tutte le colonne tranne la colonna chiave dal set di dati di input, con il nome del set di dati come prefisso.

Supporta:

  • ScriptEval negli script di caricamento.
  • ScriptEvalStr negli script di caricamento per l'ottenimento del percorso.
  • ScriptEval negli script di caricamento per l'ottenimento della distanza o della durata.

Questo è un esempio che calcola i percorsi tra punti in un set di dati:

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

Questo è un esempio che calcola i percorsi direttamente in un Livello linee. L'operazione viene richiamata per la selezione ogni volta che cambia la selezione. Normalmente deve essere presente una condizione di calcolo che risulta vera se vengono selezionati solo pochi punti (altrimenti è preferibile calcolare i percorsi nello script di caricamento). Ciò andrebbe inserito nello script di caricamento per caricare i dati. Ad esempio:

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

Utilizzare la dimensione seguente nel livello linee:

LocationDbId

Utilizzare una condizione di calcolo nel livello linee:

Count(LocationDbId)<10

Nella proprietà Location, che dovrebbe essere impostata su Geometria linee, inserire quanto segue per calcolare i percorsi da una posizione fissa ai punti selezionati:

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

Parametri per i percorsi
Parametro Tipo Utilizzare Descrizione
set di dati Set di dati predefinito: Nessuno. Un set di dati con origini e destinazioni per i percorsi da calcolare. Le origini devono essere nella geometria del set di dati. Supporta lo streaming di questo set di dati quando inviato dallo script di caricamento, in modo da consentire tabelle di dimensioni maggiori.
criteri stringa predefinito:fastest Scegliere se calcolare il percorso fastest o shortest.
trasporto stringa predefinito:car La modalità di trasporto, ovvero car (auto), truck (camion), bike (bicicletta), pedestrian (pedone) o bird (volo d'uccello) (che vola a 10 m/s).
destField stringa predefinito: Nessuno. Il campo nel set di dati che specifica la destinazione. Notare che l'origine è il campo di geometria specificato nel set di dati.
Tipo geometria stringa predefinito:PUNTO Tipo di geometria in destField. I valori consentiti sono Point, NamedPoint e LatLon. In caso di punti denominati, la geometria viene ricercata nel servizio posizione e viene aggiunta una colonna per la geometria.
suffisso stringa predefinito: Nessuno. Per utenti avanzati. La stringa specificata è aggiunta a tutti gli ID. Si tratta di un modo comodo per specificare più informazioni ai servizi di posizione basati su server, come codice Paese o tipo. L'alternativa è aggiungere i dati extra al momento di caricare la tabella in Qlik. Con il seguente suffisso, tutti gli elementi vengono specificati come città in Svezia:
,SE:city
Vedere la Guida servizio posizioni per ulteriori informazioni su quale sintassi utilizzare.
precisione numero intero predefinito:6 Imposta il numero di decimali a cui arrotondare nelle coordinate. Il valore predefinito è 6 decimali, preciso a circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore a un numero negativo.

Simplify

Semplifica le geometrie di linea e area in un set di dati. Risulta spesso utile caricare i dati geografici con l'operazione Simplify al posto dell'operazione Load per ottenere geometrie più efficienti e più rapide da visualizzare.

Il grado di semplificazione viene calcolato automaticamente in base all'area, al numero di oggetti e alla dimensione degli oggetti. È quindi possibile regolarlo a una risoluzione maggiore o minore con il parametro resolution.

La semplificazione dell'area viene effettuata con un algoritmo che gestisce le topologie e che può rimuovere i vuoti e unire le isole.

La semplificazione delle linee avviene con un algoritmo di riduzione dei punti di controllo.

Tenere presente che le sovrapposizioni di poligoni vengono rimosse. Non sarà presente alcuna sovrapposizione di poligoni nell'output.

Restituisce le seguenti colonne:

  • <dataset key column> - La colonna chiave dal dataset1 di input.
  • Simplified_<geometry column name> - Versioni semplificate delle geometrie originali.
  • Tutte le colonne tranne la colonna chiave dal set di dati, con il nome del set di dati come prefisso.

Supporta:

  • ScriptEval negli script di caricamento.

Esempio che carica versioni semplificate degli stati USA:

Load * Extension GeoOperations.ScriptEval(' SELECT LocationDbId, Simplified_LocationPolygon FROM Simplify() DATASOURCE states LOCATIONSERVICE type="State", country="us" ');
Parametri per Simplify
Parametro Tipo Utilizzare Descrizione
risoluzione stringa predefinito:Auto Il set di dati risultante è semplificato e il grado di semplificazione è controllato da questa proprietà. I valori disponibili sono:
  • Auto - L'operazione calcola una risoluzione basata sui dati.
  • AutoLow - Una risoluzione che è inferiore (metà) rispetto alla Risoluzione automatica.
  • AutoHigh - Una risoluzione che è superiore (doppia) rispetto alla Risoluzione automatica.
set di dati Set di dati predefinito:<primo set di dati> Il set di dati con le geometrie da semplificare.
precisione numero intero predefinito:6 Imposta il numero di decimali a cui arrotondare nelle coordinate. Il valore predefinito è 6 decimali, preciso a circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore a un numero negativo.

TravelAreas

Calcola le aree ISO del tempo di viaggio. Tutte le posizioni all'interno dell'area restituita possono essere raggiunte all'interno di un determinato orario oppure risultano più vicine rispetto a una determinata distanza lungo le strade. Restituisce una tabella con id, geometria area di viaggio, punto centrale, costo, unità di costo e stato (OK o non riuscito).

Se si utilizza "bird" come tipo di trasporto, intorno alle origini vengono generati cerchi corretti geograficamente.

Restituisce le seguenti colonne:

  • <dataset key column> - La colonna chiave dal set di dati di input.
  • TravelArea - La geometria di poligoni che definisce l'area di viaggio.
  • Cost - Il costo come specificato in costValue o costField.
  • CostUnit - L'unità di costo come specificato in costUnit.
  • Status - Lo stato restituito è "OK" o "failed:" seguito da un messaggio di errore.
  • Tutte le colonne tranne la colonna chiave dal set di dati di input, con il nome del set di dati come prefisso.

Supporta:

  • ScriptEval negli script di caricamento.
  • ScriptEvalStr negli script grafico per l'ottenimento della geometria dell'area di viaggio.
  • ScriptEval negli script grafico per l'ottenimento del costo.

Questo esempio di script di caricamento genera aree di viaggio di 10 minuti a Miami e Orlando dalle coordinate:

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

Questo esempio di script di caricamento genera aree di viaggio di 10 minuti in Miami e Orlando usando punti denominati:

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

Questo esempio calcola le Aree di viaggio intorno ai punti direttamente in un Livello aree. L'operazione viene richiamata per la selezione ogni volta che cambia la selezione. Ciò andrebbe inserito nello script di caricamento per caricare i dati per l'esempio:

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

Utilizzare la dimensione seguente nel Livello aree:

LocationDbId

Utilizzare una condizione di calcolo nel Livello aree:

Count(LocationDbId)<10

Nella proprietà Posizione inserire quanto segue:

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

Parametri per TravelAreas
Parametro Tipo Utilizzare Descrizione
set di dati Set di dati predefinito:<primo set di dati> Un set di dati con origini e opzionalmente costi per i calcoli dell'area di viaggio. Supporta lo streaming di questo set di dati quando inviato dallo script di caricamento, in modo da consentire tabelle di dimensioni maggiori.
costValue numero predefinito: Nessuno. Il costo al margine dell'area restituita. Il costo può essere una lunghezza o un orario. (Vedere costUnit in basso.) Un'alternativa che consente costi singoli per ciascuna area consiste nello specificare invece il valore costField.
costField stringa predefinito: Nessuno. Un campo nel set di dati che specifica il costo. Utilizzato solo se costValue risulta vuoto.
costUnit stringa predefinito:seconds Deve essere compreso tra secondi, minuti, ore, metri, iarde, chilometri e miglia. Quando si utilizza un'unità oraria, viene calcolata l'area raggiunta all'interno di tale orario e quando viene utilizzata un'unità di lunghezza, viene calcolata l'area con una distanza di viaggio inferiore a quella specificata.
trasporto stringa predefinito:car La modalità di trasporto, ovvero car (auto), truck (camion), bike (bicicletta), pedestrian (pedone) o bird (volo d'uccello) (che vola a 10 m/s).
precisione numero intero predefinito:6 Imposta il numero di decimali a cui arrotondare nelle coordinate. Il valore predefinito è 6 decimali, preciso a circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore a un numero negativo.

Within

Restituisce le relazioni tra due set di dati in cui una geometria in un set di dati (racchiuso) si trova completamente all'interno dell'area nell'altro set di dati (che racchiude). Restituisce una tabella che mappa tra la chiave nel set di dati racchiuso e la chiave nel set di dati che racchiude per tutte le relazioni trovate.

Da utilizzare all'interno in genere per trovare le aree in cui si trovano i dati. Ad esempio, per testare la posizione GPS per l'area amministrativa in cui si trovano. Si tratta di una specie di geocodifica inversa.

Restituisce le seguenti colonne:

  • <enclosed name>_<enclosing name>_RelationId - Una chiave generata per la relazione tra le due geometrie.
  • <enclosed key column> - La colonna chiave dal dataset1 input.
  • <enclosing key column> - La colonna chiave dal dataset2 input.
  • Tutte le colonne tranne la colonna chiave dal set di dati enclosed, con il nome set di dati come prefisso.
  • Tutte le colonne tranne la colonna chiave dal set di dati enclosing, con il nome set di dati come prefisso.

Supporta:

  • ScriptEval negli script di caricamento.

Per compensare le imprecisioni nei dati, a volte è meglio utilizzare Closest al posto di Within. Ad esempio, se si dispone di dati relativi ai punti in aree costiere che si desidera associare ad aree amministrative, piccole imprecisioni possono posizionare i punti leggermente all'esterno delle aree.

Questo è un esempio di script di caricamento che calcola quali punti si trovano all'interno di quali stati:

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);
Parametri per Within
Parametro Tipo Utilizzare Descrizione
racchiuso Set di dati predefinito:<primo set di dati> Un set di dati con geometrie per testare quali aree racchiudono. Supporta lo streaming di questo set di dati quando inviato dallo script di caricamento, in modo da consentire tabelle di dimensioni maggiori.
racchiuso Set di dati predefinito:<secondo set di dati> Un set di dati con geometrie di aree per testare quali geometrie racchiudono. Supporta lo streaming di questo set di dati quando inviato dallo script di caricamento, in modo da consentire tabelle di dimensioni maggiori.
precisione numero intero predefinito:6 Imposta il numero di decimali a cui arrotondare nelle coordinate. Il valore predefinito è 6 decimali, preciso a circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore a un numero negativo.
 

Hai trovato utile questa pagina?

Se riscontri problemi con questa pagina o con il suo contenuto – un errore di battitura, un passaggio mancante o un errore tecnico – facci sapere come possiamo migliorare!