Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

# Eseguire query su dati geospaziali.
<a name="querying-geospatial-data"></a>

I dati geospaziali contengono identificatori che specificano una posizione geografica per un oggetto. Esempi di questo tipo di dati includono i bollettini meteorologici, le indicazioni stradali sulle mappe, i tweet con posizioni geografiche, le ubicazioni dei negozi e le tratte delle compagnie aeree. I dati geospaziali svolgono un ruolo importante per le attività di analisi aziendale, creazione di report e di previsione.

Gli identificatori geospaziali quali latitudine e longitudine consentono di convertire qualsiasi indirizzo postale in un set di coordinate geografiche.

## Cos'è una query geospaziale?
<a name="geospatial-query-what-is"></a>

Le query geospaziali sono tipi speciali di query SQL supportati in Athena. Si differiscono dalle query SQL non spaziali nei seguenti modi:
+ Utilizzano i seguenti tipi di dati geometrici specializzati: `point`, `line`, `multiline`, `polygon` e `multipolygon`.
+ Esprimono relazioni tra tipi di dati geometrici, ad esempio `distance`, `equals`, `crosses`, `touches`, `overlaps`, `disjoint`, tra le altre.

Se si utilizzano query geospaziali in Athena, è possibile eseguire queste e altre operazioni simili:
+ Individuare la distanza tra due punti;
+ Controllare se un'area (poligono) ne contiene un'altra;
+ Controllare se una linea attraversa o tocca un'altra linea o un poligono.

Ad esempio, per ottenere un tipo di dati geometria `point` da valori di tipo `double` per le coordinate geografiche di Monte Rainier in Athena, utilizzare la funzione geospaziale `ST_Point (longitude, latitude)`, come nell'esempio seguente. 

```
ST_Point(-121.7602, 46.8527)
```

## Formati dei dati di input e tipi di dati di geometria
<a name="geospatial-input-data-formats-supported-geometry-types"></a>

Per utilizzare le funzioni geospaziali in Athena, inserisci i dati nel formato WKT o usa Hive JSON. SerDe È inoltre possibile utilizzare i tipi di dati di geometria supportati in Athena.

### Formati dei dati di input
<a name="input-data-formats"></a>

Per gestire le query geospaziali, Athena supporta i dati di input in questi formati di dati:
+  **WKT (Well-known Text)**. In Athena, WKT è rappresentato da un tipo di dati `varchar(x)` o `string`.
+  **Dati geospaziali codificati JSON**. [Per analizzare i file JSON con dati geospaziali e creare tabelle per essi, Athena utilizza Hive JSON. SerDe](https://github.com/Esri/spatial-framework-for-hadoop/wiki/Hive-JSON-SerDe) Per ulteriori informazioni sull'utilizzo di questa funzionalità SerDe in Athena, vedere. [Librerie JSON SerDe](json-serde.md)

### Tipi di dati di geometria
<a name="geometry-data-types"></a>

Per gestire le query geospaziali, Athena supporta questi tipi di dati di geometria specializzati:
+  `point` 
+  `line` 
+  `polygon` 
+  `multiline` 
+  `multipolygon` 

## Funzioni geospaziali supportate
<a name="geospatial-functions-list"></a>

Per informazioni sulle funzioni geospaziali della versione 3 del motore Athena, consulta [Funzioni geospaziali](https://trino.io/docs/current/functions/geospatial.html) nella documentazione di Trino.