Operazione | Guida di Qlik Cloud
Vai al contenuto principale Passa a contenuto complementare

Operazione

AddressPointLookup

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

La funzionalità offerta da Qlik Geocoding (tramite AddressPointLookup e PointToAddressLookup) è distinta dalle altre funzionalità di ricerca della posizione. Qlik Geocoding consente ricerche a livello di indirizzo, mentre le normali ricerche della posizione possono essere precise solo a livello di codice postale.

Quando si inizia a utilizzare Qlik Geocoding, utilizzare il modello a cui si fa riferimento in Configurazione di Qlik Geocoding (solo in lingua inglese).

Nota informatica Per ottenere risultati ottimali, privilegiare dati specifici e omettere dati generici quando possibile. Ad esempio, se si dispone sia di un codice postale che di una città postale e si ritiene che il codice postale sia corretto, è preferibile non specificare la città postale.

La maggior parte dei parametri è disponibile 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 È necessario disporre dell'autorizzazione del ruolo utente Use : per utilizzare AddressPointLookup.
Nota informatica Per geocodificare indirizzi in inglese o pinyin in Cina, il parametro Country deve essere impostato su "CHN".

Restituisce le seguenti colonne:

  • <colonna chiave del set di dati> - La colonna chiave dal set di dati di input.
  • Address - L'indirizzo trovato, formattato in base agli standard degli indirizzi 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.
  • Match - Un valore compreso tra 0 e 1 che indica la qualità della corrispondenza. Un valore pari a 1 indica una corrispondenza perfetta.
  • Tutte le colonne tranne la colonna chiave da dataset, con il nome del set di dati come prefisso.

I campi restituiti potrebbero essere vuoti se non applicabili o se i dati non sono disponibili.

Supporta:

  • ScriptEval negli script di caricamento.

Esempio che geocodifica alcuni indirizzi svedesi in cui ogni 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 a 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 Uso Descrizione
searchText stringa facoltativo Una stringa di testo da cercare. Possono essere indirizzi come: "1600 Pennsylvania Ave, Washington DC, USA" o indirizzi incompleti combinati con dati in altri campi, come "1117 Washington Ave" con City impostato su "Philadelphia" e Country impostato su "USA".
searchTextField stringa facoltativo Se searchText non è specificato, questo parametro può essere utilizzato per specificare un campo da cui recuperare le informazioni.
country stringa facoltativo Una stringa con codici ISO a tre lettere. È possibile specificare più paesi, separati da virgole: "SWE,NOR,FIN". Per geocodificare in modo specifico indirizzi in inglese o pinyin in Cina, questo parametro deve essere impostato su "CHN".
countryField stringa facoltativo Se country non è specificato, questo parametro può essere utilizzato per specificare un campo che contiene il nome del paese o i codici ISO a due o tre lettere. Si noti che, a differenza degli altri parametri, il formato previsto dei dati specificati da country e countryField non è identico. Il parametro country consente più paesi, ma solo nel formato ISO a tre lettere, mentre countryField consente formati di paese diversi.
state stringa facoltativo Nome o codice dello stato. Per la maggior parte dei paesi, lo stato non fa parte dell'indirizzo.
stateField stringa facoltativo Se state non è specificato, questo parametro può essere utilizzato per specificare un campo da cui recuperare le informazioni.
city stringa facoltativo Nome della città, comune o città postale.
cityField stringa facoltativo Se city non è specificato, questo parametro può essere utilizzato per specificare un campo da cui recuperare le informazioni.
postalCode stringa facoltativo Codice postale.
postalCodeField stringa facoltativo Se postalCode non è specificato, questo parametro può essere utilizzato per specificare un campo da cui recuperare le informazioni.
street stringa facoltativo Nome della via. Invece di specificare la via e il numero civico in parametri o campi separati, è possibile specificarli entrambi insieme, separati da uno spazio.
streetField stringa facoltativo Se street non è specificato, questo parametro può essere utilizzato per specificare un campo da cui recuperare le informazioni.
houseNumber stringa facoltativo Numero civico.
houseNumberField stringa facoltativo Se houseNumber non è specificato, questo parametro può essere utilizzato per specificare un campo da cui recuperare le informazioni.
matchThreshold real predefinito: 0.5 Restituisce solo i risultati con una corrispondenza migliore di questa. Aumentare questo valore se vengono restituiti troppi falsi risultati.
language stringa predefinito: Nessuno. Un codice lingua a due lettere per la lingua preferita per l'indirizzo nella risposta. Se l'indirizzo non è disponibile nella lingua richiesta, viene restituito in una lingua predefinita per la posizione.
dataset Dataset predefinito: Nessuno. Un set di dati con indirizzi che verranno cercati nel geocodificatore. Supporta il flusso di questo set di dati quando viene inviato dallo script di caricamento, il che significa che sono consentite tabelle più grandi.
precision integer predefinito: 6 Imposta il numero di decimali a cui arrotondare le coordinate. Il valore predefinito è 6 decimali, che ha una precisione di circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore su un numero negativo.

Binning

Genera contenitori rettangolari o esagonali per un set di dati di punti. Questo è un modo per aggregare i dati dei punti in modo da poter visualizzare in modo efficiente una panoramica dei dati.

Restituisce le seguenti colonne:

  • <colonna chiave del set di dati> - 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 da dataset, con il nome del set di dati come prefisso.

Supporta:

  • ScriptEval negli script di caricamento.

Esempio che carica contenitori esagonali dagli aeroporti degli Stati Uniti:

Load * Extension GeoOperations.ScriptEval(' Binning(type="hexagonal", gridSize="1") DATASOURCE airports LOCATIONSERVICE geometry="POINT", type="AirportIATA", country="us" ');
Parametri per Binning
Parametro Tipo Uso Descrizione
type stringa predefinito: rectangular Definisce se devono essere generati contenitori rectangular o hexagonal.
gridSize real predefinito: Nessuno. L'altezza di un singolo contenitore in gradi. Un grado corrisponde a circa 10000 m.
gridWidthHeightRatio real predefinito: 1.5 Il rapporto larghezza-altezza dei contenitori. I contenitori quadrati sono spesso ottimali, ma ciò varia in base alla latitudine. La formula per il rapporto larghezza-altezza ottimale è 1/cos(latitudine), ad esempio 1 all'equatore, 1,15 alla latitudine +-30 gradi e 2 alla latitudine +-60 gradi. Spesso è preferibile visualizzare i dati raggruppati nella proiezione adattiva rispetto alla proiezione di Mercatore.
dataset Dataset predefinito: Nessuno. Il set di dati con le geometrie dei punti per cui generare i contenitori. Supporta il flusso di questo set di dati quando viene inviato dallo script di caricamento, il che significa che sono consentite tabelle più grandi.
precision integer predefinito: 6 Imposta il numero di decimali a cui arrotondare le coordinate. Il valore predefinito è 6 decimali, che ha una precisione di circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore su un numero negativo.

Closest

Restituisce le relazioni e le distanze tra gli oggetti in un set di dati e gli oggetti più vicini in un altro, se qualcuno è più vicino della distanza massima. Il costo può anche essere calcolato lungo le strade e, in tal caso, utilizzare facoltativamente il tempo di percorrenza. Questa operazione è utile in molti casi, non solo per ottenere le relazioni con gli oggetti più vicini, ma anche per ottenere matrici di distanza tra un insieme di punti.

Restituisce le seguenti colonne:

  • <nome dataset1>_<nome dataset2>_RelationId - Una chiave generata per la relazione tra le due geometrie.
  • <colonna chiave dataset1> - La colonna chiave dal dataset1 di input.
  • <colonna chiave dataset2> - La colonna chiave dal dataset2 di 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 trova 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 Closest
Parametro Tipo Uso Descrizione
distance real predefinito: Nessuno. Distanza massima dall'unità specificata in Unità di costo. Gli elementi più distanti di questa vengono ignorati.
costUnit stringa predefinito: meters Deve essere uno tra meters, yards, kilometers, miles, seconds, minutes o hours. L'utilizzo di unità di tempo implica che il tempo di percorrenza venga utilizzato come costo e le unità di lunghezza che venga utilizzata la distanza. Le unità di tempo non sono consentite per il tipo di distanza Bird.
distanceType real predefinito: Bird Decide come vengono misurate le distanze. Sono consentiti i seguenti valori:
  • Bird - misura le distanze dirette (in linea d'aria) tra gli oggetti.
  • Car - misura lungo le strade con restrizioni per le auto. Supportato solo per i set di dati di punti.
  • Bike - misura lungo le strade con restrizioni per le biciclette. Supportato solo per i set di dati di punti.
  • Pedestrian - misura lungo le strade con restrizioni per i pedoni. Supportato solo per i set di dati di punti.
  • Truck - misura lungo le strade con restrizioni per i camion. Supportato solo per i set di dati di punti.
closestCount real predefinito: 1 Numero di oggetti nel secondo set di dati da associare a un oggetto nel primo set di dati. Un valore pari a 1 indica solo il più vicino, 2 indica i due più vicini e così via.
dataset1 Dataset predefinito: <primo set di dati> Oggetti di cui verificare la vicinanza agli oggetti in dataset2 se specificato, altrimenti agli oggetti in se stesso. Quando si verifica la vicinanza tra oggetti in un singolo set di dati, le relazioni non vengono mai aggiunte da un oggetto a se stesso. Supporta il flusso di questo set di dati quando viene inviato dallo script di caricamento e dataset2 è definito, il che significa che sono consentite tabelle più grandi.
dataset2 Dataset predefinito: <secondo set di dati, se presente> Oggetti da mettere in relazione con gli oggetti in dataset1.
precision integer predefinito: 6 Imposta il numero di decimali a cui arrotondare le coordinate. Il valore predefinito è 6 decimali, che ha una precisione di circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore su un numero negativo.

Cluster

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

Restituisce le seguenti colonne:

  • <colonna chiave del set di dati> - La colonna chiave dal set di dati di input.
  • ClusterID - ID del cluster a cui appartiene il punto.
  • Clusters.ClusterPoint - Punto centrale del 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 raggruppa gli aeroporti negli Stati Uniti in modo che gli aeroporti a meno di 50 km di distanza 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 Uso Descrizione
distance real predefinito: Nessuno. La distanza tra un punto e il suo cluster non può essere superiore a questa distanza in metri.
dataset Dataset predefinito: Nessuno. Un set di dati con punti da raggruppare in cluster.
precision integer predefinito: 6 Imposta il numero di decimali a cui arrotondare le coordinate. Il valore predefinito è 6 decimali, che ha una precisione di circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore su un numero negativo.

Dissolve

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

Restituisce le seguenti colonne:

  • <dissolveField> - Il campo specificato come dissolveField nei dati di input.
  • DissolvedPolygon - Le geometrie delle nuove aree dissolte.

Supporta:

  • ScriptEval negli script di caricamento.

Il set di dati della geometria è facoltativo. Se non fornito, si presuppone che le geometrie siano disponibili nel set di dati di definizione della dissolvenza.

Si noti che le sovrapposizioni di poligoni vengono rimosse in tutte le risoluzioni tranne Source.

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 Dissolve
Parametro Tipo Uso Descrizione
dissolveField stringa predefinito: <stesso nome del campo chiave in dissolveDataset> Il nome del campo con le identità delle nuove aree in dissolveDataset.
resolution stringa predefinito: Auto Il set di dati risultante viene semplificato e il grado di semplificazione è controllato da questa proprietà. I valori disponibili sono:
  • auto - L'operazione calcola una risoluzione in base ai dati.
  • autolow - Una risoluzione inferiore (la metà) alla risoluzione Auto.
  • autohigh - Una risoluzione superiore (il doppio) alla risoluzione Auto.
  • source - Non viene eseguita alcuna semplificazione. Si noti 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. Viene utilizzato solo se è specificato areaDataset.
dissolveDataset Dataset predefinito: <primo set di dati> La definizione della nuova area a cui appartiene ciascuna vecchia area, ovvero una mappatura tra le identità della vecchia area e della nuova area. 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 Dataset predefinito: <secondo set di dati, se presente> Il set di dati con le geometrie delle aree da dissolvere. Può essere nessuno, il che significa che le geometrie devono essere disponibili in dissolveDataset. Il campo areaDatasetKeyField in questo set di dati deve essere collegato al campo chiave in dissolveDataset.
precision integer predefinito: 6 Imposta il numero di decimali a cui arrotondare le coordinate. Il valore predefinito è 6 decimali, che ha una precisione di circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore su un numero negativo.

Intersects

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

È possibile limitare il numero di geometrie intersecanti nel secondo set di dati che devono essere mappate a ciascuna geometria nel primo set di dati specificando intersectsCount. Quindi le geometrie più intersecanti vengono restituite in ordine. L'operazione è simmetrica se intersectsCount non è specificato.

Restituisce le seguenti colonne:

  • <nome dataset1>_<nome dataset2>_RelationId - Una chiave generata per la relazione tra le due geometrie.
  • <colonna chiave dataset1> - La colonna chiave dal dataset1 di input.
  • <colonna chiave dataset2> - La colonna chiave dal dataset2 di input.
  • <nome dataset1>.RelativeOverlap - La sovrapposizione rispetto al poligono in dataset1. Restituito solo se entrambi i set di dati contengono poligoni. La richiesta di questo campo comporta una penalizzazione delle prestazioni.
  • <nome dataset2>.RelativeOverlap - La sovrapposizione rispetto al poligono in dataset2. Restituito solo se entrambi i set di dati contengono poligoni. La richiesta di questo campo comporta una penalizzazione delle prestazioni.
  • 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 Intersects
Parametro Tipo Uso Descrizione
dataset1 Dataset predefinito: <primo set di dati> Un set di dati con geometrie da testare per verificare 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 verifica l'intersezione tra oggetti in un singolo set di dati, le relazioni non vengono mai aggiunte da un oggetto a se stesso. Supporta il flusso di questo set di dati quando viene inviato dallo script di caricamento e quando dataset2 è definito, il che significa che sono consentite tabelle più grandi.
dataset2 Dataset predefinito: <secondo set di dati, se presente> Un set di dati con geometrie da testare per verificare quali intersecano le geometrie nell'altro set di dati. Se non specificato, viene calcolata l'intersezione tra gli oggetti in dataset1.
intersectsCount integer predefinito: 0 Se maggiore di 0, viene restituito al massimo questo numero di geometrie intersecanti in dataset2 per geometria in dataset1. Vengono restituite solo quelle che si intersecano maggiormente (area o lunghezza di sovrapposizione maggiore).
precision integer predefinito: 6 Imposta il numero di decimali a cui arrotondare le coordinate. Il valore predefinito è 6 decimali, che ha una precisione di circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore su un numero negativo.

IpLookup

Restituisce informazioni sulla posizione e geometrie dei punti per gli indirizzi IP in una tabella. Questo è utile quando si analizzano i dati di accesso ai servizi Web. La tabella restituita contiene i seguenti campi:
  • Campo chiave - Lo stesso del campo chiave per la tabella dei nomi.
  • <Campo IP della tabella degli indirizzi> - Lo stesso del campo IP che è stato cercato. Disponibile solo se non è uguale 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. Si noti che questo codice non è sempre compatibile con il codice restituito dal servizio di 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 individuare una città, ma per altri è possibile risolvere solo il paese.

La procedura consigliata consiste nell'inviare solo la colonna IP all'operazione IpLookup. Esempio che cerca 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 molte righe. In tal caso, migliora le prestazioni filtrare prima 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;

Questo prodotto include i dati GeoLite2 creati da MaxMind, disponibili su MaxMind.

Parametri per IpLookup
Parametro Tipo Uso Descrizione
ipField stringa facoltativo Il campo con l'indirizzo IP da cercare. Utilizza il campo chiave del set di dati se non specificato.
dataset Dataset predefinito: Nessuno. Un set di dati con indirizzi IP che verranno cercati nel geocodificatore. Supporta il flusso di questo set di dati quando viene inviato dallo script di caricamento, il che significa che sono consentite tabelle più grandi.
precision integer predefinito: 6 Imposta il numero di decimali a cui arrotondare le coordinate. Il valore predefinito è 6 decimali, che ha una precisione di circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore su un numero negativo.

Load

Carica il set di dati senza alcuna operazione applicata. Ciò consente di caricare tutti i formati supportati da GeoOperations. Si noti che Simplify può essere una buona alternativa a Load se le geometrie sono dettagliate e lente da visualizzare.

Restituisce le seguenti colonne:

  • Tutte le colonne da dataset.

Supporta:

  • ScriptEval negli script di caricamento.

Esempio che carica i codici postali dalla Svezia:

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

Poiché WKT è supportato come formato di geometria per i dati in INTABLE, l'operazione Load è eccellente per convertire le geometrie geografiche caricate da un database nel formato di geometria Sense in modo che possano essere visualizzate. 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 Uso Descrizione
dataset Dataset predefinito: <primo set di dati> Set di dati da caricare. Supporta il flusso di questo set di dati quando viene inviato dallo script di caricamento, il che significa che sono consentite tabelle più grandi.
precision integer predefinito: 6 Imposta il numero di decimali a cui arrotondare le coordinate. Il valore predefinito è 6 decimali, che ha una precisione di circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore su 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 si ripiegherà sulla restituzione di risultati a livello di area postale o di città. Per i punti troppo lontani, non viene restituito alcun dato.

Nota informatica È necessario disporre dell'autorizzazione del ruolo utente Use : per utilizzare PointToAddressLookup.

Restituisce le seguenti colonne:

  • <colonna chiave del set di dati> - La colonna chiave dal set di dati di input.
  • Address - L'indirizzo trovato, formattato in base agli standard degli indirizzi 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 dall'indirizzo trovato.
  • Tutte le colonne tranne la colonna chiave da dataset, con il nome del set di dati come prefisso.

Si noti che i campi restituiti potrebbero essere vuoti se non applicabili o se 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 Uso Descrizione
language stringa predefinito: Un codice lingua a due lettere per la lingua preferita per l'indirizzo nella risposta. Se l'indirizzo non è disponibile nella lingua richiesta, viene restituito in una lingua predefinita per la posizione.
dataset Dataset predefinito: Nessuno. Un set di dati con punti che verranno cercati nel geocodificatore. Supporta il flusso di questo set di dati quando viene inviato dallo script di caricamento, il che significa che sono consentite tabelle più grandi.
precision integer predefinito: 6 Imposta il numero di decimali a cui arrotondare le coordinate. Il valore predefinito è 6 decimali, che ha una precisione di circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore su un numero negativo.

Routes

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

Si noti che l'origine è la colonna della geometria nel set di dati. La colonna di destinazione è specificata nei parametri dell'operazione poiché i set di dati conoscono solo una colonna della geometria.

Se si utilizza bird come tipo di trasporto, vengono generati archi di cerchio massimo tra origini e destinazioni.

Restituisce le seguenti colonne:

  • <colonna chiave del set di dati> - La colonna chiave dal set di dati di input.
  • Distance - La distanza del percorso in metri.
  • Duration - Il tempo di percorrenza stimato del percorso 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 del grafico per ottenere il percorso.
  • ScriptEval negli script del grafico per ottenere la distanza o la durata.

Questo è un esempio che calcola i percorsi tra i 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 linea. L'operazione viene chiamata per la selezione ogni volta che la selezione cambia. Normalmente dovrebbe esserci una condizione di calcolo che è vera se vengono selezionati solo pochi punti (altrimenti è meglio calcolare i percorsi nello script di caricamento). Questo dovrebbe essere 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 seguente dimensione nel livello linea:

LocationDbId

Utilizzare una condizione di calcolo nel livello linea:

Count(LocationDbId)<10

Nella proprietà Posizione, che dovrebbe essere impostata su Line geometry, inserire questo 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 Routes
Parametro Tipo Uso Descrizione
dataset Dataset predefinito: Nessuno. Un set di dati con origini e destinazioni per i percorsi da calcolare. Le origini dovrebbero trovarsi nella geometria del set di dati. Supporta il flusso di questo set di dati quando viene inviato dallo script di caricamento, il che significa che sono consentite tabelle più grandi.
criteria stringa predefinito: fastest Scegliere tra il percorso fastest o shortest da calcolare.
transportation stringa predefinito: car La modalità di trasporto, una tra car, truck, bike, pedestrian o bird (che vola a 10 m/s).
destField stringa predefinito: Nessuno. Il campo nel set di dati che specifica la destinazione. Si noti che l'origine è il campo della geometria specificato nel set di dati.
geometryType stringa predefinito: POINT Tipo di geometria in destField. I valori consentiti sono Point, NamedPoint e LatLon. Nel caso di punti denominati, la geometria viene cercata nel servizio di posizione e viene aggiunta una colonna per la geometria.
suffix stringa predefinito: Nessuno. Per utenti avanzati. La stringa specificata viene aggiunta a tutti gli ID. Questo è un modo conveniente per specificare ulteriori informazioni ai servizi di posizione basati su server, come il codice del paese o il tipo. L'alternativa è aggiungere i dati extra durante il caricamento della tabella in Qlik. Con il seguente suffisso tutti gli elementi sono specificati come città in Svezia:
,SE:city
Per ulteriori informazioni sulla sintassi da utilizzare, consultare la Guida al servizio di posizione.
precision integer predefinito: 6 Imposta il numero di decimali a cui arrotondare le coordinate. Il valore predefinito è 6 decimali, che ha una precisione di circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore su un numero negativo.

Simplify

Semplifica le geometrie di linee e aree in un set di dati. Spesso è utile caricare dati geografici con l'operazione Simplify anziché con l'operazione Load per ottenere geometrie più efficienti e più veloci da visualizzare.

Il grado di semplificazione viene calcolato automaticamente in base all'area, al numero di oggetti e alle dimensioni degli oggetti. È quindi possibile regolarlo su una risoluzione superiore o inferiore con il parametro resolution.

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

La semplificazione della linea viene eseguita con un algoritmo di riduzione dei punti di interruzione.

Si noti che le sovrapposizioni di poligoni vengono rimosse. Non ci saranno poligoni sovrapposti nell'output.

Restituisce le seguenti colonne:

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

Supporta:

  • ScriptEval negli script di caricamento.

Esempio che carica versioni semplificate degli stati degli Stati Uniti:

Load * Extension GeoOperations.ScriptEval(' SELECT LocationDbId, Simplified_LocationPolygon FROM Simplify() DATASOURCE states LOCATIONSERVICE type="State", country="us" ');
Parametri per Simplify
Parametro Tipo Uso Descrizione
resolution stringa predefinito: Auto Il set di dati risultante viene semplificato e il grado di semplificazione è controllato da questa proprietà. I valori disponibili sono:
  • Auto - L'operazione calcola una risoluzione in base ai dati.
  • AutoLow - Una risoluzione inferiore (la metà) alla risoluzione Auto.
  • AutoHigh - Una risoluzione superiore (il doppio) alla risoluzione Auto.
dataset Dataset predefinito: <primo set di dati> Il set di dati con le geometrie da semplificare.
precision integer predefinito: 6 Imposta il numero di decimali a cui arrotondare le coordinate. Il valore predefinito è 6 decimali, che ha una precisione di circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore su un numero negativo.

TravelAreas

Calcola le aree ISO del tempo di percorrenza. Tutte le posizioni all'interno dell'area restituita possono essere raggiunte entro un certo tempo o sono più vicine di una certa distanza lungo le strade. Restituisce una tabella con ID, geometria dell'area di viaggio, punto centrale, costo, unità di costo e stato (OK o failed).

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

Restituisce le seguenti colonne:

  • <colonna chiave del set di dati> - La colonna chiave dal set di dati di input.
  • TravelArea - La geometria del poligono che definisce l'area di viaggio.
  • Cost - Il costo come specificato in costValue o costField.
  • CostUnit - L'unità di costo come specificata 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 del grafico per ottenere la geometria dell'area di viaggio.
  • ScriptEval negli script del grafico per ottenere il 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 a Miami e Orlando utilizzando 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 è un esempio che calcola le aree di viaggio attorno ai punti direttamente in un livello area. L'operazione viene chiamata per la selezione ogni volta che la selezione cambia. Questo dovrebbe essere 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 seguente dimensione nel livello area:

LocationDbId

Utilizzare una condizione di calcolo nel livello area:

Count(LocationDbId)<10

Nella proprietà Posizione inserire questo:

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

Parametri per TravelAreas
Parametro Tipo Uso Descrizione
dataset Dataset predefinito: <primo set di dati> Un set di dati con origini e facoltativamente costi per i calcoli dell'area di viaggio. Supporta il flusso di questo set di dati quando viene inviato dallo script di caricamento, il che significa che sono consentite tabelle più grandi.
costValue number predefinito: Nessuno. Il costo al confine dell'area restituita. Il costo può essere una lunghezza o un tempo. (Vedere costUnit di seguito). Un'alternativa che consente costi individuali per ciascuna area consiste nello specificare invece costField.
costField stringa predefinito: Nessuno. Un campo nel set di dati che specifica il costo. Viene utilizzato solo se costValue è vuoto.
costUnit stringa predefinito: seconds Deve essere uno tra seconds, minutes, hours, meters, yards, kilometers o miles. Quando viene utilizzata un'unità di tempo, viene calcolata l'area raggiunta entro quel tempo e, quando viene utilizzata un'unità di lunghezza, viene calcolata l'area con una distanza di viaggio inferiore a quella specificata.
transportation stringa predefinito: car La modalità di trasporto, una tra car, truck, bike, pedestrian o bird (che vola a 10 m/s).
precision integer predefinito: 6 Imposta il numero di decimali a cui arrotondare le coordinate. Il valore predefinito è 6 decimali, che ha una precisione di circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore su un numero negativo.

Within

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

Utilizzare within in genere per trovare in quali aree si trovano i dati; ad esempio, per testare la posizione GPS per l'area amministrativa in cui si trovano. Questa è una sorta di geocodifica inversa.

Restituisce le seguenti colonne:

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

Supporta:

  • ScriptEval negli script di caricamento.

Per compensare le imprecisioni nei dati, a volte è meglio utilizzare Closest invece di Within. Ad esempio, se si dispone di dati di punti in aree costiere che si desidera mettere in relazione con aree amministrative, piccole imprecisioni possono far sì che i punti cadano leggermente al di fuori 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 Uso Descrizione
enclosed Dataset predefinito: <primo set di dati> Un set di dati con geometrie da testare per verificare da quali aree sono racchiuse. Supporta il flusso di questo set di dati quando viene inviato dallo script di caricamento, il che significa che sono consentite tabelle più grandi.
enclosing Dataset predefinito: <secondo set di dati> Un set di dati con geometrie di area da testare per verificare quali geometrie racchiudono. Supporta il flusso di questo set di dati quando viene inviato dallo script di caricamento, il che significa che sono consentite tabelle più grandi.
precision integer predefinito: 6 Imposta il numero di decimali a cui arrotondare le coordinate. Il valore predefinito è 6 decimali, che ha una precisione di circa 10 cm. Se non si desidera arrotondare le coordinate, impostare il valore su 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 – ti pregiamo di farcelo sapere!