你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
MapsSearchClient.SearchInsideGeometryAsync 方法
定义
重要
一些信息与预发行产品相关,相应产品在发行之前可能会进行重大修改。 对于此处提供的信息,Microsoft 不作任何明示或暗示的担保。
重载
SearchInsideGeometryAsync(String, GeoObject, SearchInsideGeometryOptions, CancellationToken) |
在几何图形内搜索。 搜索几何图形终结点允许在单个或多个几何图形内执行自由表单搜索。 将返回位于 geometry/geometries 中的搜索结果。<br><br>若要发送几何图形,将使用 |
SearchInsideGeometryAsync(String, GeoCollection, SearchInsideGeometryOptions, CancellationToken) |
在几何图形内搜索。 搜索几何图形终结点允许在单个或多个几何图形内执行自由表单搜索。 将返回位于 geometry/geometries 中的搜索结果。<br><br>若要发送几何图形,将使用 |
SearchInsideGeometryAsync(String, GeoObject, SearchInsideGeometryOptions, CancellationToken)
- Source:
- MapsSearchClient.cs
在几何图形内搜索。 搜索几何图形终结点允许在单个或多个几何图形内执行自由表单搜索。 将返回位于 geometry/geometries 中的搜索结果。<br><br>若要发送几何图形,将使用 POST
请求,其中请求正文将包含 geometry
表示为 GeoJSON
类型的对象, Content-Type
并且标头将设置为 application/json
。 要搜索的地理特征可以建模为使用下列 GeoJSON
任一类型表示的多边形和/或圆形几何图形:<ul><li>GeoJSON FeatureCollection<br>可以 geometry
表示为 GeoJSON FeatureCollection
对象。 如果几何图形同时包含多边形和圆圈,则这是建议的选项。 最多 FeatureCollection
可以包含 50 GeoJSON Feature
个对象。 每个Feature
对象应表示具有以下条件的 Polygon 或 Circle:<ul style=“list-style-type:none”><li>Polygon Feature
geometry 对象最多可以有 50 个坐标,并且其属性必须为空。</li><li>圆形Feature
几何图形的对象由使用 GeoJSON Point
类型表示的中心和半径值 (米) ,必须在对象的属性中指定,以及值应为“Circle”的 subType 属性。</li></ul><br> 有关示例FeatureCollection
表示形式,请参阅下面的示例部分。<br><br></li><li>GeoJSON GeometryCollection<br>可以geometry
表示为GeoJSON GeometryCollection
对象。 如果几何图形仅包含多边形列表,则建议使用此选项。 最多 GeometryCollection
可以包含 50 GeoJSON Polygon
个对象。 每个 Polygon
对象最多可以有 50 个坐标。 有关示例 GeometryCollection
表示形式,请参阅下面的示例部分。<br><br></li><li>GeoJSON Polygon<br>可以 geometry
表示为 GeoJSON Polygon
对象。 如果几何图形包含单个多边形,则这是建议的选项。 对象 Polygon
最多可以有 50 个坐标。 有关示例 Polygon
表示形式,请参阅下面的示例部分。<br><br></li></ul>.<br><br>
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Maps.Search.Models.SearchAddressResult>> SearchInsideGeometryAsync (string query, Azure.Core.GeoJson.GeoObject geometry, Azure.Maps.Search.SearchInsideGeometryOptions options = default, System.Threading.CancellationToken cancellationToken = default);
abstract member SearchInsideGeometryAsync : string * Azure.Core.GeoJson.GeoObject * Azure.Maps.Search.SearchInsideGeometryOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Maps.Search.Models.SearchAddressResult>>
override this.SearchInsideGeometryAsync : string * Azure.Core.GeoJson.GeoObject * Azure.Maps.Search.SearchInsideGeometryOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Maps.Search.Models.SearchAddressResult>>
Public Overridable Function SearchInsideGeometryAsync (query As String, geometry As GeoObject, Optional options As SearchInsideGeometryOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of SearchAddressResult))
参数
- query
- String
要搜索的 POI 名称 (,例如“自由女神像”、“星巴克”) ,必须正确编码 URL。
- options
- SearchInsideGeometryOptions
其他选项
- cancellationToken
- CancellationToken
要使用的取消标记。
返回
注解
在几何图形内搜索
适用于
SearchInsideGeometryAsync(String, GeoCollection, SearchInsideGeometryOptions, CancellationToken)
- Source:
- MapsSearchClient.cs
在几何图形内搜索。 搜索几何图形终结点允许在单个或多个几何图形内执行自由表单搜索。 将返回位于 geometry/geometries 中的搜索结果。<br><br>若要发送几何图形,将使用 POST
请求,其中请求正文将包含 geometry
表示为 GeoJSON
类型的对象, Content-Type
并且标头将设置为 application/json
。 要搜索的地理特征可以建模为使用下列 GeoJSON
任一类型表示的多边形和/或圆形几何图形:<ul><li>GeoJSON FeatureCollection<br>可以 geometry
表示为 GeoJSON FeatureCollection
对象。 如果几何图形同时包含多边形和圆圈,则这是建议的选项。 最多 FeatureCollection
可以包含 50 GeoJSON Feature
个对象。 每个Feature
对象应表示具有以下条件的 Polygon 或 Circle:<ul style=“list-style-type:none”><li>Polygon Feature
geometry 对象最多可以有 50 个坐标,并且其属性必须为空。</li><li>圆形Feature
几何图形的对象由使用 GeoJSON Point
类型表示的中心和半径值 (米) ,必须在对象的属性中指定,以及值应为“Circle”的 subType 属性。</li></ul><br> 有关示例FeatureCollection
表示形式,请参阅下面的示例部分。<br><br></li><li>GeoJSON GeometryCollection<br>可以geometry
表示为GeoJSON GeometryCollection
对象。 如果几何图形仅包含多边形列表,则建议使用此选项。 最多 GeometryCollection
可以包含 50 GeoJSON Polygon
个对象。 每个 Polygon
对象最多可以有 50 个坐标。 有关示例 GeometryCollection
表示形式,请参阅下面的示例部分。<br><br></li><li>GeoJSON Polygon<br>可以 geometry
表示为 GeoJSON Polygon
对象。 如果几何图形包含单个多边形,则这是建议的选项。 对象 Polygon
最多可以有 50 个坐标。 有关示例 Polygon
表示形式,请参阅下面的示例部分。<br><br></li></ul>.<br><br>
public virtual System.Threading.Tasks.Task<Azure.Response<Azure.Maps.Search.Models.SearchAddressResult>> SearchInsideGeometryAsync (string query, Azure.Core.GeoJson.GeoCollection geometryCollection, Azure.Maps.Search.SearchInsideGeometryOptions options = default, System.Threading.CancellationToken cancellationToken = default);
abstract member SearchInsideGeometryAsync : string * Azure.Core.GeoJson.GeoCollection * Azure.Maps.Search.SearchInsideGeometryOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Maps.Search.Models.SearchAddressResult>>
override this.SearchInsideGeometryAsync : string * Azure.Core.GeoJson.GeoCollection * Azure.Maps.Search.SearchInsideGeometryOptions * System.Threading.CancellationToken -> System.Threading.Tasks.Task<Azure.Response<Azure.Maps.Search.Models.SearchAddressResult>>
Public Overridable Function SearchInsideGeometryAsync (query As String, geometryCollection As GeoCollection, Optional options As SearchInsideGeometryOptions = Nothing, Optional cancellationToken As CancellationToken = Nothing) As Task(Of Response(Of SearchAddressResult))
参数
- query
- String
要搜索的 POI 名称 (,例如“自由女神像”、“星巴克”) ,必须正确编码 URL。
- geometryCollection
- GeoCollection
这表示一个或多个地理特征的几何图形, (公园、州边界等) 搜索,并且应是符合 GeoJSON 的类型。 有关详细信息,请参阅 RFC 7946 。
- options
- SearchInsideGeometryOptions
其他选项
- cancellationToken
- CancellationToken
要使用的取消标记。
返回
注解
在几何图形内搜索