Partage via


Présentation des fonctions géospatiales Stream Analytics

Les fonctions géospatiales d’Azure Stream Analytics permettent d’effectuer une analytique en temps réel des données géospatiales de streaming. Avec seulement quelques lignes de code, vous pouvez développer une solution de production adaptée aux scénarios complexes. Ces fonctions prennent en charge tous les types WKT et les géométries GeoJSON Point, Polygon et LineString.

Voici quelques exemples de scénarios qui peuvent bénéficier des fonctions géospatiales :

  • Le covoiturage
  • La gestion de flotte
  • Suivi des ressources
  • Délimitation géographique
  • Traçage des téléphones sur les stations cellulaires

Le langage de requête Stream Analytics possède sept fonctions géospatiales intégrées : CreateLineString, CreatePoint, CreatePolygon, ST_DISTANCE, ST_OVERLAPS, ST_INTERSECTS et ST_WITHIN.

CreateLineString

La fonction CreateLineString accepte des points et retourne un LineString GeoJSON, qui peut être tracé sous la forme d’une ligne sur une carte. Vous devez avoir au moins deux points pour créer un LineString. Les points LineString seront connectés dans l’ordre.

La requête suivante utilise CreateLineString pour créer un LineString à l’aide de trois points. Le premier point est créé à partir des données d’entrée de streaming, et les deux autres sont créés manuellement.

SELECT  
     CreateLineString(CreatePoint(input.latitude, input.longitude), CreatePoint(10.0, 10.0), CreatePoint(10.5, 10.5))  
FROM input  

Exemple d’entrée

latitude longitude
3.0 -10.2
-87.33 20.2321

Exemple de sortie

{"type" : "LineString", "coordinates" : [ [-10.2, 3.0], [10.0, 10.0], [10.5, 10.5] ]}

{"type" : "LineString", "coordinates" : [ [20.2321, -87.33], [10.0, 10.0], [10.5, 10.5] ]}

Pour plus d’informations, consultez la référence CreateLineString.

CreatePoint

La fonction CreatePoint accepte une latitude et une longitude, et retourne un point GeoJSON, qui peut être tracé sur une carte. Le type de données de vos latitudes et de vos longitudes doit être float.

L’exemple de requête suivant utilise CreatePoint pour créer un point à l’aide des latitudes et des longitudes issues des données d’entrée de streaming.

SELECT  
     CreatePoint(input.latitude, input.longitude)  
FROM input 

Exemple d’entrée

latitude longitude
3.0 -10.2
-87.33 20.2321

Exemple de sortie

{"type" : "Point", "coordinates" : [-10.2, 3.0]}

{"type" : "Point", "coordinates" : [20.2321, -87.33]}

Pour plus d’informations, consultez la référence CreatePoint.

CreatePolygon

La fonction CreatePolygon accepte des points et retourne un enregistrement de polygone GeoJSON. L’ordre des points doit respecter le sens antihoraire. Imaginez-vous marcher d’un point à l’autre dans l’ordre dans lequel ils sont déclarés. Le centre du polygone se trouverait toujours sur votre gauche.

L’exemple de requête suivant utilise CreatePolygon pour créer un polygone à partir de trois points. Les deux premiers points sont créés manuellement, et le dernier point est créé à partir des données d’entrée.

SELECT  
     CreatePolygon(CreatePoint(input.latitude, input.longitude), CreatePoint(10.0, 10.0), CreatePoint(10.5, 10.5), CreatePoint(input.latitude, input.longitude))  
FROM input  

Exemple d’entrée

latitude longitude
3.0 -10.2
-87.33 20.2321

Exemple de sortie

{"type" : "Polygon", "coordinates" : [[ [-10.2, 3.0], [10.0, 10.0], [10.5, 10.5], [-10.2, 3.0] ]]}

{"type" : "Polygon", "coordinates" : [[ [20.2321, -87.33], [10.0, 10.0], [10.5, 10.5], [20.2321, -87.33] ]]}

Pour plus d’informations, consultez la référence CreatePolygon.

ST_DISTANCE

La fonction ST_DISTANCE retourne la distance en mètres entre deux géométries.

La requête suivante utilise ST_DISTANCE pour générer un événement lorsqu’une station-service se trouve à moins de 10 kilomètres de votre voiture.

SELECT Cars.Location, Station.Location 
FROM Cars c  
JOIN Station s ON ST_DISTANCE(c.Location, s.Location) < 10 * 1000

Pour plus d’informations, consultez la référence ST_DISTANCE.

ST_OVERLAPS

La fonction ST_OVERLAPS compare deux géométries. Si les géométries se chevauchent, la fonction retourne la valeur 1. Si les géométries ne se chevauchent pas, la fonction retourne la valeur 0.

La requête suivante utilise ST_OVERLAPS pour générer un événement lorsqu’un bâtiment se trouve dans une zone inondable.

SELECT Building.Polygon, Building.Polygon 
FROM Building b 
JOIN Flooding f ON ST_OVERLAPS(b.Polygon, b.Polygon) 

La requête suivante génère un événement lorsqu’une tempête arrive en direction d’une voiture.

SELECT Cars.Location, Storm.Course
FROM Cars c, Storm s
JOIN Storm s ON ST_OVERLAPS(c.Location, s.Course)

Pour plus d’informations, consultez la référence ST_OVERLAPS.

ST_INTERSECTS

La fonction ST_INTERSECTS compare deux géométries. Si les géométries se croisent, la fonction retourne la valeur 1. Si les géométries ne se croisent pas, la fonction retourne la valeur 0.

L’exemple de requête suivant utilise ST_INTERSECTS pour déterminer si une route pavée croise un chemin de terre.

SELECT  
     ST_INTERSECTS(input.pavedRoad, input.dirtRoad)  
FROM input  

Exemple d’entrée

datacenterArea stormArea
{"type":"LineString", "coordinates": [ [-10.0, 0.0], [0.0, 0.0], [10.0, 0.0] ]} {"type":"LineString", "coordinates": [ [0.0, 10.0], [0.0, 0.0], [0.0, -10.0] ]}
{"type":"LineString", "coordinates": [ [-10.0, 0.0], [0.0, 0.0], [10.0, 0.0] ]} {"type":"LineString", "coordinates": [ [-10.0, 10.0], [0.0, 10.0], [10.0, 10.0] ]}

Exemple de sortie

1

0

Pour plus d’informations, consultez la référence ST_INTERSECTS.

ST_WITHIN

La fonction ST_WITHIN détermine si une géométrie se trouve dans une autre géométrie. Si la première est contenue dans la dernière, la fonction retourne la valeur 1. Si la première géométrie n’est pas située dans la dernière, la fonction retourne la valeur 0.

L’exemple de requête suivant utilise ST_WITHIN pour déterminer si le point de la destination de livraison se trouve dans le polygone d’entrepôt donné.

SELECT  
     ST_WITHIN(input.deliveryDestination, input.warehouse)  
FROM input 

Exemple d’entrée

deliveryDestination warehouse
{"type":"Point", "coordinates": [76.6, 10.1]} {"type":"Polygon", "coordinates": [ [0.0, 0.0], [10.0, 0.0], [10.0, 10.0], [0.0, 10.0], [0.0, 0.0] ]}
{"type":"Point", "coordinates": [15.0, 15.0]} {"type":"Polygon", "coordinates": [ [10.0, 10.0], [20.0, 10.0], [20.0, 20.0], [10.0, 20.0], [10.0, 10.0] ]}

Exemple de sortie

0

1

Pour plus d’informations, consultez la référence ST_WITHIN.

Étapes suivantes