共用方式為

串流分析地理空間函式簡介

  • 發行項

Azure 串流分析中的地理空間函式可即時分析串流地理空間資料。 只要撰寫幾行程式碼，就能開發適用於複雜案例的生產等級解決方案。 這些函式支援所有 WKT 類型和 GeoJSON Point、Polygon 和 LineString。

可受益於地理空間函式的案例範例包括：

  • 汽車共乘
  • 車隊管理
  • 資產追蹤
  • 異地隔離
  • 跨基地台進行電話追蹤

串流分析查詢語言具有七個內建的地理空間函式：CreateLineString、Createpoint、CreatePolygon、ST_DISTANCE、ST_OVERLAPS、ST_INTERSECTS 和 ST_WITHIN。

CreateLineString

CreateLineString 函式會接受點，並傳回 GeoJSON LineString，以在地圖上繪製為線條。 您必須有至少兩個點才能建立 LineString。 LineString 點會依序連接。

下列查詢使用 CreateLineString 來建立使用三個點的 LineString。 第一個點會透過串流輸入資料來建立，另外兩個點則以手動方式建立。

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

輸入範例

緯度 經度
3.0 -10.2
-87.33 20.2321

輸出範例

{"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] ]}

若要深入了解，請瀏覽 CreateLineString 參考。

CreatePoint

CreatePoint 函式會接受經緯度，並傳回 GeoJSON 點，以繪製在地圖上。 經緯度必須是浮點數資料類型。

下列查詢範例使用 CreatePoint 來建立點，這個點所使用的經緯度來自串流輸入資料。

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

輸入範例

緯度 經度
3.0 -10.2
-87.33 20.2321

輸出範例

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

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

若要深入了解，請瀏覽 CreatePoint 參考。

CreatePolygon

CreatePolygon 函式會接受點，並傳回 GeoJSON 多邊形記錄。 點的順序必須依照右手定則方向，也就是逆時針方向。 想像一下以這些點所宣告的順序從一個點走到另一個點。 在整個過程中，此多邊形的中心會在您的左側。

下列查詢範例使用 CreatePolygon 從三個點建立多邊形。 前兩個點以手動方式建立，最後一個點則從輸入資料建立。

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

輸入範例

緯度 經度
3.0 -10.2
-87.33 20.2321

輸出範例

{"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] ]]}

若要深入了解，請瀏覽 CreatePolygon 參考。

ST_DISTANCE

ST_DISTANCE函式會傳回兩點之間的距離 (以公尺為單位)。

下列查詢使用 ST_DISTANCE 以在加油站與車輛的距離小於 10 公里時產生事件。

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

若要深入了解，請瀏覽 ST_DISTANCE 參考。

ST_OVERLAPS

ST_OVERLAPS函式會比較兩個幾何。 如果幾何重疊，則函式會傳回 1。 如果幾何未重疊，則函式會傳回 0。

下列查詢使用 ST_OVERLAPS 以在大樓位於可能淹水的區域內時產生事件。

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

下列查詢範例會在暴風雨朝車輛方向行進時產生事件。

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

若要深入了解，請瀏覽 ST_OVERLAPS 參考。

ST_INTERSECTS

ST_INTERSECTS函式會比較兩個幾何。 如果幾何有交集，則函式會傳回 1。 如果幾何未交集，則函式會傳回 0。

下列查詢範例使用 ST_INTERSECTS 來判斷柏油路是否與泥土路相交。

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

輸入範例

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] ]}

輸出範例

1

0

若要深入了解，請瀏覽 ST_INTERSECTS 參考。

ST_WITHIN

該ST_WITHIN函式會判斷一個幾何是否在另一個幾何內。 如果第一個包含在最後一個中，則函式會傳回 1。 如果第一個幾何並不在最後一個幾何內，則函式會傳回 0。

下列查詢範例使用 ST_WITHIN 來判斷交貨目的地所在點是否位於指定的倉儲多邊形內。

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

輸入範例

deliveryDestination 倉儲
{“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] ]}

輸出範例

0

1

若要深入了解，請瀏覽 ST_WITHIN 參考。

下一步