geo_point_in_circle()geo_point_in_circle()

Calcola se le coordinate geospaziali si trovano all'interno di un cerchio sulla terra.Calculates whether the geospatial coordinates are inside a circle on Earth.

SintassiSyntax

geo_point_in_circle(p_longitude , p_latitude , pc_longitude , pc_latitude , C_radius)geo_point_in_circle(p_longitude, p_latitude, pc_longitude, pc_latitude, c_radius)

ArgomentiArguments

  • p_longitude: valore Longitudine della coordinata geospaziale in gradi.p_longitude: Geospatial coordinate longitude value in degrees. Il valore valido è un numero reale e compreso nell'intervallo [-180, + 180].Valid value is a real number and in the range [-180, +180].
  • p_latitude: valore di latitudine della coordinata geospaziale in gradi.p_latitude: Geospatial coordinate latitude value in degrees. Il valore valido è un numero reale e compreso nell'intervallo [-90, + 90].Valid value is a real number and in the range [-90, +90].
  • pc_longitude: valore Longitudine della coordinata geospaziale del cerchio centrale in gradi.pc_longitude: Circle center geospatial coordinate longitude value in degrees. Il valore valido è un numero reale e compreso nell'intervallo [-180, + 180].Valid value is a real number and in the range [-180, +180].
  • pc_latitude: valore di latitudine della coordinata geospaziale del cerchio centrale in gradi.pc_latitude: circle center geospatial coordinate latitude value in degrees. Il valore valido è un numero reale e compreso nell'intervallo [-90, + 90].Valid value is a real number and in the range [-90, +90].
  • C_radius: raggio in metri cerchio.c_radius: Circle radius in meters. Il valore valido deve essere positivo.Valid value must be positive.

RestituisceReturns

Indica se le coordinate geospaziali si trovano all'interno di un cerchio.Indicates whether the geospatial coordinates are inside a circle. Se le coordinate o il cerchio non è valido, la query produrrà un risultato null.If the coordinates or circle is invalid, the query will produce a null result.

Nota

  • Le coordinate geospaziali vengono interpretate come rappresentate dal sistema di riferimento delle coordinate WGS-84 .The geospatial coordinates are interpreted as represented by the WGS-84 coordinate reference system.
  • Il datum geodetico usato per misurare la distanza sulla terra è una sfera.The geodetic datum used to measure distance on Earth is a sphere.
  • Un cerchio è una copertura sferica sulla terra.A circle is a spherical cap on Earth. Il raggio del perno viene misurato lungo la superficie della sfera.The radius of the cap is measured along the surface of the sphere.

EsempioExamples

La query seguente consente di trovare tutte le posizioni nell'area definita dal cerchio seguente: raggio di 18 km, al centro alle coordinate di [-122,317404, 47,609119].The following query finds all the places in the area defined by the following circle: Radius of 18 km, center at [-122.317404, 47.609119] coordinates.

Posti vicino a Seattle

datatable(longitude:real, latitude:real, place:string)
[
    real(-122.317404), 47.609119, 'Seattle',                   // In circle 
    real(-123.497688), 47.458098, 'Olympic National Forest',   // In exterior of circle  
    real(-122.201741), 47.677084, 'Kirkland',                  // In circle
    real(-122.443663), 47.247092, 'Tacoma',                    // In exterior of circle
    real(-122.121975), 47.671345, 'Redmond',                   // In circle
]
| where geo_point_in_circle(longitude, latitude, -122.317404, 47.609119, 18000)
| project place
placeplace
SeattleSeattle
KirklandKirkland
RedmondRedmond

Eventi Storm in Orlando.Storm events in Orlando. Gli eventi vengono filtrati in base a 100 km entro le coordinate di Orlando e aggregati per tipo di evento e hash.The events are filtered by 100 km within Orlando coordinates, and aggregated by event type and hash.

Eventi Storm in Orlando

StormEvents
| project BeginLon, BeginLat, EventType
| where geo_point_in_circle(BeginLon, BeginLat, real(-81.3891), 28.5346, 1000 * 100)
| summarize count() by EventType, hash = geo_point_to_s2cell(BeginLon, BeginLat)
| project geo_s2cell_to_central_point(hash), EventType, count_
| render piechart with (kind=map) // map rendering available in Kusto Explorer desktop

Nell'esempio seguente vengono mostrati i pickup di NY taxi entro 10 metri di una determinata località.The following example shows NY Taxi pickups within 10 meters of a particular location. I pickup rilevanti sono aggregati in base all'hash.Relevant pickups are aggregated by hash.

Pickup vicini a NY taxi

nyc_taxi
| project pickup_longitude, pickup_latitude
| where geo_point_in_circle( pickup_longitude, pickup_latitude, real(-73.9928), 40.7429, 10)
| summarize by hash = geo_point_to_s2cell(pickup_longitude, pickup_latitude, 22)
| project geo_s2cell_to_central_point(hash)
| render scatterchart with (kind = map) // map rendering available in Kusto Explorer desktop

Nell'esempio seguente viene restituito true.The following example will return true.

print in_circle = geo_point_in_circle(-122.143564, 47.535677, -122.100896, 47.527351, 3500)
in_circlein_circle
11

Nell'esempio seguente viene restituito false.The following example will return false.

print in_circle = geo_point_in_circle(-122.137575, 47.630683, -122.100896, 47.527351, 3500)
in_circlein_circle
00

Nell'esempio seguente viene restituito un risultato null a causa dell'input della coordinata non valido.The following example will return a null result because of the invalid coordinate input.

print in_circle = geo_point_in_circle(200, 1, 1, 1, 1)
in_circlein_circle

Nell'esempio seguente viene restituito un risultato null a causa dell'input RADIUS del cerchio non valido.The following example will return a null result because of the invalid circle radius input.

print in_circle = geo_point_in_circle(1, 1, 1, 1, -1)
in_circlein_circle