你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Search - Get Search Nearby
用于搜索特定位置附近的兴趣点。
API Get Search Nearby
是一个 HTTP GET
请求,对于检索特定位置的 POI 结果最有用。 此终结点仅返回 POI 结果,不采用搜索查询参数。
GET https://atlas.microsoft.com/search/nearby/{format}?api-version=1.0&lat={lat}&lon={lon}
GET https://atlas.microsoft.com/search/nearby/{format}?api-version=1.0&lat={lat}&lon={lon}&limit={limit}&ofs={ofs}&categorySet={categorySet}&countrySet={countrySet}&radius={radius}&language={language}&extendedPostalCodesFor={extendedPostalCodesFor}&brandSet={brandSet}&connectorSet={connectorSet}&view={view}
URI 参数
名称 | 在 | 必需 | 类型 | 说明 |
---|---|---|---|---|
format
|
path | True |
响应的所需格式。 值可以是 json 或 xml。 |
|
api-version
|
query | True |
string |
Azure Maps API 的版本号。 |
lat
|
query | True |
number double |
结果应有偏差的纬度。 例如 37.337。 |
lon
|
query | True |
number double |
结果应有偏差的经度。 例如 -121.89。 |
brand
|
query |
string[] |
一个逗号分隔的品牌名称列表,可用于将结果限制为特定品牌。 项顺序并不重要。 当提供多个品牌时,仅返回至少) (所提供列表之一的结果。 名称中包含 “,”的品牌应放在引号中。 用法示例: brandSet=Foo brandSet=Foo,Bar brandSet=“A,B,C 逗号”,条形图 |
|
category
|
query |
integer[] |
类别集 ID 的逗号分隔列表,可用于将结果限制为特定的兴趣点类别。 ID 顺序并不重要。 每个请求支持的最大值数
|
|
connector
|
query |
连接器类型的逗号分隔列表,可用于将结果限制为支持特定连接器类型的电动汽车站。 项顺序并不重要。 如果提供了多个连接器类型,则仅返回至少) (所提供列表之一的结果。 可用的连接器类型包括:
用法示例: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached |
||
country
|
query |
string[] |
以逗号分隔的国家/地区代码字符串,例如 FR,ES。 这会将搜索限制为指定的国家/地区 |
|
extended
|
query |
结果中应包含扩展邮政编码的索引。 可用索引包括: Addr = 地址范围 地理位置 = 地理位置 PAD = 点地址 POI = 兴趣点 Str = 街道 XStr = 十字路口 (十字路口) 值应为以逗号分隔的索引类型列表, (以任何顺序) 或 None (对于无索引)。 默认情况下,除 Geo 之外的所有索引都包含扩展邮政编码。 地理位置的扩展邮政编码列表可能很长,因此必须在需要时显式请求它们。 用法示例: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None 扩展邮政编码作为地址的 extendedPostalCode 属性返回。 可用性取决于区域。 |
||
language
|
query |
string |
返回搜索结果时应采用的语言。 应是受支持的 IETF 语言标记之一,不区分大小写。 当指定语言的数据不适用于特定字段时,将使用默认语言。 有关详细信息,请参阅 支持的语言 。 |
|
limit
|
query |
integer |
将返回的最大响应数。 默认值:10,最小值:1,最大值:100 |
|
ofs
|
query |
integer |
完整结果集中返回结果的起始偏移量。 默认值:0 |
|
radius
|
query |
integer |
结果要限制为定义的区域的半径(以米为单位),最小值为 1,最大值为 50000。 |
|
view
|
query |
View 参数 (也称为“用户区域”参数) 允许你为地缘政治争议区域显示特定国家/地区的正确地图。 不同的国家/地区对此类区域有不同的视图,并且 View 参数允许应用程序符合应用程序将服务的国家/地区所需的视图。 默认情况下,View 参数设置为“Unified”,即使尚未在请求中定义它。 由你负责确定用户的位置,然后为该位置正确设置 View 参数。 或者,可以选择设置“View=Auto”,这将基于请求的 IP 地址返回地图数据。 Azure Maps 中的 View 参数的使用必须符合适用的法律,包括与地图、图像和其他数据以及你有权通过Azure Maps访问的第三方内容的国家/地区相关的法律。 示例:view=IN。 有关详细信息和可用的 视图 ,请参阅支持的视图。 |
请求头
名称 | 必需 | 类型 | 说明 |
---|---|---|---|
x-ms-client-id |
string |
指定要与Microsoft Entra ID安全模型结合使用的帐户。 它表示Azure Maps帐户的唯一 ID,可从Azure Maps管理平面帐户 API 检索。 若要在 Azure Maps 中使用Microsoft Entra ID安全性,请参阅以下文章以获取指导。 |
响应
名称 | 类型 | 说明 |
---|---|---|
200 OK |
确定 |
|
Other Status Codes |
发生了意外错误。 |
安全性
AADToken
这些是Microsoft Entra OAuth 2.0 流。 与 Azure 基于角色的访问控制配对时,它可用于控制对Azure Maps REST API 的访问。 Azure 基于角色的访问控制用于指定对一个或多个Azure Maps资源帐户或子资源的访问权限。 可以通过内置角色或由一个或多个权限组成的自定义角色授予任何用户、组或服务主体的访问权限,以Azure Maps REST API。
若要实现方案,建议查看 身份验证概念。 总之,此安全定义提供了一种解决方案,用于通过能够对特定 API 和作用域进行访问控制的对象对应用程序 () 建模。
注意
- 此安全定义需要使用
x-ms-client-id
标头来指示应用程序请求访问的Azure Maps资源。 这可以从 地图管理 API 获取。 -
Authorization URL
特定于 Azure 公有云实例。 主权云具有唯一的授权 URL 和Microsoft Entra ID配置。 - Azure 基于角色的访问控制是通过 Azure 门户、PowerShell、CLI、Azure SDK 或 REST API 从 Azure 管理平面配置的。
- 使用 Azure Maps Web SDK 可以针对多个用例对应用程序进行基于配置的设置。
- 有关Microsoft 标识平台的详细信息,请参阅Microsoft 标识平台概述。
类型:
oauth2
流向:
implicit
授权 URL:
https://login.microsoftonline.com/common/oauth2/authorize
作用域
名称 | 说明 |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
这是在Azure 门户或使用 PowerShell、CLI、Azure SDK 或 REST API 创建Azure Maps帐户时预配的共享密钥。
使用此密钥,任何应用程序都可以访问所有 REST API。 换句话说,此密钥可用作颁发密钥的帐户中的主密钥。
对于公开的应用程序,我们建议使用机密客户端应用程序方法来访问Azure Maps REST API,以便安全地存储密钥。
类型:
apiKey
在:
query
SAS Token
这是一个共享访问签名令牌,通过 Azure 门户、PowerShell、CLI、Azure SDK 或 REST API,通过 Azure 管理平面在Azure Maps资源上列出 SAS 操作创建。
使用此令牌,任何应用程序都有权使用 Azure 基于角色的访问控制进行访问,并精细控制特定令牌的过期、速率和区域 () 。 换句话说,SAS 令牌可用于允许应用程序以比共享密钥更安全的方式控制访问。
对于公开的应用程序,我们建议在 Map 帐户资源 上配置允许的来源的特定列表,以限制呈现滥用,并定期续订 SAS 令牌。
类型:
apiKey
在:
header
示例
Search for any points of interest (POI) within 5 miles of Manhattan NY and return the top 10 results
示例请求
GET https://atlas.microsoft.com/search/nearby/json?api-version=1.0&lat=40.70627&lon=-74.011454&limit=10&radius=8046
示例响应
{
"summary": {
"queryType": "NEARBY",
"queryTime": 137,
"numResults": 10,
"offset": 0,
"totalResults": 256620,
"fuzzyLevel": 1,
"geoBias": {
"lat": 40.70627,
"lon": -74.011454
}
},
"results": [
{
"type": "POI",
"id": "US/POI/p1/7652731",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369002225435-US",
"poi": {
"name": "Ycd Multimedia",
"phone": "+(1)-(212)-5091049",
"categorySet": [
{
"id": 9152
}
],
"classifications": [
{
"code": "NON_GOVERNMENTAL_ORGANIZATION",
"names": [
{
"nameLocale": "en-US",
"name": "non governmental organization"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/7652732",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369001882610-US",
"poi": {
"name": "Grubb & Ellis Management Services",
"phone": "+(1)-(212)-7851619",
"categorySet": [
{
"id": 9352039
}
],
"classifications": [
{
"code": "COMPANY",
"names": [
{
"nameLocale": "en-US",
"name": "company"
},
{
"nameLocale": "en-US",
"name": "services"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/7652735",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369001322824-US",
"poi": {
"name": "Hispanic Federation",
"phone": "+(1)-(212)-7420480",
"categorySet": [
{
"id": 9910004
}
],
"url": "Hispanicfederation.org",
"classifications": [
{
"code": "AUTOMOTIVE_DEALER",
"names": [
{
"nameLocale": "en-US",
"name": "boat"
},
{
"nameLocale": "en-US",
"name": "automotive dealer"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/7652736",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369000631230-US",
"poi": {
"name": "Edwin Gould Foundation",
"phone": "+(1)-(212)-9825200",
"categorySet": [
{
"id": 9152
}
],
"url": "edwingouldfoundation.org",
"classifications": [
{
"code": "NON_GOVERNMENTAL_ORGANIZATION",
"names": [
{
"nameLocale": "en-US",
"name": "non governmental organization"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/7652737",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369001196585-US",
"poi": {
"name": "Newmark Grubb Knight Frank",
"phone": "+(1)-(646)-6951990",
"categorySet": [
{
"id": 9361015
}
],
"url": "www.newmarkkf.com",
"classifications": [
{
"code": "SHOP",
"names": [
{
"nameLocale": "en-US",
"name": "shop"
},
{
"nameLocale": "en-US",
"name": "real estate agents"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p1/7652738",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369002164164-US",
"poi": {
"name": "Sponsors For Educational Opportunity",
"phone": "+(1)-(212)-7851361",
"categorySet": [
{
"id": 9152
}
],
"url": "www.seo-usa.org",
"classifications": [
{
"code": "NON_GOVERNMENTAL_ORGANIZATION",
"names": [
{
"nameLocale": "en-US",
"name": "non governmental organization"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/7373205",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840361001736646-US",
"poi": {
"name": "Visiting Nurse Service",
"phone": "+(1)-(212)-7428259",
"categorySet": [
{
"id": 9663
}
],
"url": "www.vnsny.org",
"classifications": [
{
"code": "HEALTH_CARE_SERVICE",
"names": [
{
"nameLocale": "en-US",
"name": "health care service"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/7373206",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840361001326915-US",
"poi": {
"name": "Hispanic In Philanthropy",
"phone": "+(1)-(646)-2777101",
"categorySet": [
{
"id": 9152
}
],
"url": "www.hiponline.org",
"classifications": [
{
"code": "NON_GOVERNMENTAL_ORGANIZATION",
"names": [
{
"nameLocale": "en-US",
"name": "non governmental organization"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/7373207",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369002316633-US",
"poi": {
"name": "Advantage Technical Resourcing",
"phone": "+(1)-(212)-2691140",
"categorySet": [
{
"id": 9352039
}
],
"classifications": [
{
"code": "COMPANY",
"names": [
{
"nameLocale": "en-US",
"name": "company"
},
{
"nameLocale": "en-US",
"name": "services"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
},
{
"type": "POI",
"id": "US/POI/p0/7373208",
"score": 1,
"dist": 14.736843483489132,
"info": "search:ta:840369002031974-US",
"poi": {
"name": "Workshop In Bus Opportunities",
"phone": "+(1)-(212)-6840854",
"categorySet": [
{
"id": 9352039
}
],
"url": "www.wibo.org",
"classifications": [
{
"code": "COMPANY",
"names": [
{
"nameLocale": "en-US",
"name": "company"
},
{
"nameLocale": "en-US",
"name": "services"
}
]
}
]
},
"address": {
"streetNumber": "55",
"streetName": "Exchange Pl",
"municipalitySubdivision": "New York City, NYC, New York, Financial District",
"municipality": "Wall Street, New York City, NYC, NY City, NY, Manhattan, Bowling Green, New York",
"countrySecondarySubdivision": "New York",
"countryTertiarySubdivision": "Manhattan",
"countrySubdivisionCode": "NY",
"postalCode": "10004",
"extendedPostalCode": "100042320",
"countryCode": "US",
"country": "United States Of America",
"countryCodeISO3": "USA",
"freeformAddress": "55 Exchange Pl, New York, NY 10004",
"countrySubdivisionName": "New York"
},
"position": {
"lat": 40.7064,
"lon": -74.01142
},
"viewport": {
"topLeftPoint": {
"lat": 40.7073,
"lon": -74.01261
},
"btmRightPoint": {
"lat": 40.7055,
"lon": -74.01023
}
},
"entryPoints": [
{
"type": "main",
"position": {
"lat": 40.70636,
"lon": -74.01145
}
}
]
}
]
}
定义
名称 | 说明 |
---|---|
Address |
结果的地址 |
Address |
描述搜索结果街道两侧的地址范围。 包括地址范围的开始和结束位置的坐标。 |
Bounding |
覆盖视区左上坐标和右下坐标表示的结果的视区。 |
Bounding |
位置的边界框。 |
Brand |
与 POI 关联的品牌 |
Classification |
要返回的 POI 的分类 |
Classification |
分类的名称 |
Data |
可选节。 用于 Get 搜索 Polygon API 的引用 ID。 |
Electric |
连接器类型的逗号分隔列表,可用于将结果限制为支持特定连接器类型的电动汽车站。 项顺序并不重要。 提供多个连接器类型时,将仅返回至少) (列表之一的结果。 可用的连接器类型包括:
用法示例: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached |
Entity |
边界框的实体类型源。 对于反向地理编码,这始终等于位置。 |
Entry |
要返回的 POI 的入口点。 |
Entry |
入口点的类型。 值可以是main或次要值。 |
Error |
资源管理错误附加信息。 |
Error |
错误详细信息。 |
Error |
错误响应 |
Geographic |
Geography 实体类型。 仅在请求 entityType 且可用时显示。 |
Geometry |
有关结果的几何形状的信息。 仅当类型 == Geography 时才存在。 |
Lat |
使用短名称“lat”&“lon”表示为纬度和经度的位置。 |
Localized |
View 参数 (也称为“用户区域”参数,) 允许您为地缘政治争议区域显示特定国家/地区的正确地图。 不同的国家/地区对此类区域有不同的视图,并且 View 参数允许应用程序符合应用程序将服务的国家/地区所需的视图。 默认情况下,View 参数设置为“Unified”,即使你尚未在请求中定义它。 你有责任确定用户的位置,然后为该位置正确设置 View 参数。 或者,可以选择设置“View=Auto”,这将基于请求的 IP 地址返回地图数据。 Azure Maps 中的 View 参数的使用必须符合适用法律,包括有关地图、图像和其他数据以及你有权通过Azure Maps访问的第三方内容的国家/地区的法律。 示例:view=IN。 有关详细信息,请参阅 支持的视图 ,并查看可用的视图。 |
Match |
反向地址搜索操作的匹配类型。 |
Operating |
POI (兴趣点) 的营业时间。 |
Operating |
表示日期和时间 |
Operating |
一天的开放时间范围 |
Point |
返回的 POI 的详细信息,包括姓名、电话、URL 地址和分类等信息。 |
Point |
POI 类别 |
Query |
返回的查询类型:“附近”或“NON_NEAR”。 |
Response |
响应的所需格式。 值可以是 json 或 xml。 |
Search |
此对象是从成功的搜索调用返回的。 |
Search |
搜索 API 响应的结果对象。 |
Search |
下列其中一项:
|
Search |
结果中应包含扩展邮政编码的索引。 可用索引包括: Addr = 地址范围 Geo = Geographies PAD = 点地址 POI = 兴趣点 Str = Streets XStr = 十字路口 (交叉口) 值应该是以逗号分隔的索引类型列表, (以任何顺序) 或 无 索引。 默认情况下,除 Geo 之外的所有索引都包含扩展邮政编码。 地理位置的扩展邮政编码列表可能很长,因此必须在需要时显式请求它们。 用法示例: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None 扩展邮政编码作为地址的 extendedPostalCode 属性返回。 可用性依赖于区域。 |
Search |
搜索 API 响应的摘要对象。 |
Address
结果的地址
名称 | 类型 | 说明 |
---|---|---|
boundingBox |
位置的边界框。 |
|
buildingNumber |
string |
街上的建筑号。 已弃用,请改用 streetNumber。 |
country |
string |
国家/地区名称 |
countryCode |
string |
国家/地区 (注意:这是一个双字母代码,而不是国家/地区名称。) |
countryCodeISO3 |
string |
ISO alpha-3 国家/地区代码 |
countrySecondarySubdivision |
string |
县 |
countrySubdivision |
string |
省/市/自治区 |
countrySubdivisionCode |
string |
|
countrySubdivisionName |
string |
第一级国家/地区管理层次结构的全名。 仅当 countrySubdivision 以缩写形式显示时,才会显示此字段。 仅支持美国、加拿大和英国。 |
countryTertiarySubdivision |
string |
命名区域 |
crossStreet |
string |
要交叉的街道的名称。 |
extendedPostalCode |
string |
扩展的邮政编码 (可用性取决于区域) 。 |
freeformAddress |
string |
根据 Result 所在国家/地区的格式规则设置格式的地址行,如果是国家/地区,则为其完整国家/地区名称。 |
localName |
string |
一个地址组件,表示地理区域或位置的名称,该地理区域或位置对多个可寻址对象进行分组以用于寻址,而不作为管理单元。 此字段用于生成 |
municipality |
string |
城市/城镇 |
municipalitySubdivision |
string |
亚/超级城市 |
neighbourhood |
string |
邻里是城市或城镇内的地理本地化区域,具有鲜明的特点和居民之间的社会互动。 |
postalCode |
string |
邮政编码/邮政编码 |
routeNumbers |
string[] |
用于明确标识街道的代码 |
street |
string |
街道名称。 已弃用,请改用 streetName。 |
streetName |
string |
街道名称。 |
streetNameAndNumber |
string |
街道名称和编号。 |
streetNumber |
string |
街上的楼号。 |
AddressRanges
描述搜索结果街道两侧的地址范围。 包括地址范围的开始和结束位置的坐标。
名称 | 类型 | 说明 |
---|---|---|
from |
使用短名称“lat”&“lon”表示为纬度和经度的位置。 |
|
rangeLeft |
string |
街道左侧的地址范围。 |
rangeRight |
string |
街道右侧的地址范围。 |
to |
使用短名称“lat”&“lon”表示为纬度和经度的位置。 |
BoundingBox
覆盖视区左上坐标和右下坐标表示的结果的视区。
名称 | 类型 | 说明 |
---|---|---|
btmRightPoint |
使用短名称“lat”&“lon”表示为纬度和经度的位置。 |
|
topLeftPoint |
使用短名称“lat”&“lon”表示为纬度和经度的位置。 |
BoundingBoxCompassNotation
位置的边界框。
名称 | 类型 | 说明 |
---|---|---|
entity |
边界框的实体类型源。 对于反向地理编码,这始终等于位置。 |
|
northEast |
string |
以逗号分隔浮点分隔的边界框的东北纬度、经度坐标 |
southWest |
string |
以逗号分隔的浮点为边界框的西南纬度、经度坐标 |
Brand
与 POI 关联的品牌
名称 | 类型 | 说明 |
---|---|---|
name |
string |
品牌名称 |
Classification
要返回的 POI 的分类
名称 | 类型 | 说明 |
---|---|---|
code |
string |
Code 属性 |
names |
名称数组 |
ClassificationName
分类的名称
名称 | 类型 | 说明 |
---|---|---|
name |
string |
Name 属性 |
nameLocale |
string |
名称区域设置属性 |
DataSources
可选节。 用于 Get 搜索 Polygon API 的引用 ID。
名称 | 类型 | 说明 |
---|---|---|
geometry |
有关结果的几何形状的信息。 仅当类型 == Geography 时才存在。 |
ElectricVehicleConnector
连接器类型的逗号分隔列表,可用于将结果限制为支持特定连接器类型的电动汽车站。 项顺序并不重要。 提供多个连接器类型时,将仅返回至少) (列表之一的结果。
可用的连接器类型包括:
-
StandardHouseholdCountrySpecific
- 这些是特定区域的标准家用连接器。 它们都是交流单相以及标准电压和标准安培。 另请参阅: 插头 & 插槽类型 - 世界标准。 -
IEC62196Type1
- IEC 62196-2 标准中定义的类型 1 连接器。 也称为 Yazaki 之后的原始制造商或 SAE J1772 标准后,首次发布它。 主要与 120V 单相或高达 240V 单相基础结构结合使用。 -
IEC62196Type1CCS
- IEC 62196-3 标准中定义的基于类型 1 的组合连接器。 该连接器基于类型 1 连接器(如 IEC 62196-2 标准所定义),另外还有两个直流 (DC) 触点,允许 DC 快速充电。 -
IEC62196Type2CableAttached
- IEC 62196-2 标准中定义的类型 2 连接器。 作为连接到充电点的电缆和插头提供。 -
IEC62196Type2Outlet
- IEC 62196-2 标准中定义的类型 2 连接器。 作为一个插座提供给充电点。 -
IEC62196Type2CCS
- IEC 62196-3 标准中定义的基于类型 2 的组合连接器。 该连接器基于类型 2 连接器(如 IEC 62196-2 标准所定义),另外还有两个直流 (DC) 触点,允许 DC 快速充电。 -
IEC62196Type3
- IEC 62196-2 标准中定义的类型 3 连接器。 在原始制造商之后也称为“骗子”。 主要与高达 240V 的单相或高达 420V 的三相基础结构结合使用。 -
Chademo
- CHAdeMO 连接器以东京电力公司和工业合作伙伴组成的协会命名。 因此,也称为 TEPCO 的连接器。 它支持快速 DC 充电。 -
IEC60309AC1PhaseBlue
- 工业蓝连接器是 IEC 60309 标准中定义的连接器。 它有时称为标准、颜色和单相连接器的某种组合。 连接器通常具有“P+N+E,6h”配置。 -
IEC60309DCWhite
- 工业白色连接器是 IEC 60309 标准中定义的 DC 连接器。 -
Tesla
- Tesla 连接器是特定于区域的特斯拉增压器连接器。 也就是说,它指的是特斯拉的专有连接器,有时称为特斯拉端口,主要限于北美或修改后的 Type 2 (DC 超过类型 2 在欧洲) 。
用法示例:
connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached
名称 | 类型 | 说明 |
---|---|---|
Chademo |
string |
CHAdeMO 连接器以东京电力公司和工业合作伙伴组成的协会命名。 因此,也称为 TEPCO 的连接器。 它支持快速 DC 充电。 |
IEC60309AC1PhaseBlue |
string |
工业蓝连接器是 IEC 60309 标准中定义的连接器。 它有时称为标准、颜色和单相连接器的某种组合。 连接器通常具有“P+N+E,6h”配置。 |
IEC60309DCWhite |
string |
工业白色连接器是 IEC 60309 标准中定义的 DC 连接器。 |
IEC62196Type1 |
string |
IEC 62196-2 标准中定义的类型 1 连接器。 也称为 Yazaki 之后的原始制造商或 SAE J1772 标准后,首次发布它。 主要与 120V 单相或高达 240V 单相基础结构结合使用。 |
IEC62196Type1CCS |
string |
IEC 62196-3 标准中定义的基于类型 1 的组合连接器。 该连接器基于类型 1 连接器(如 IEC 62196-2 标准所定义),另外还有两个直流 (DC) 触点,允许 DC 快速充电。 |
IEC62196Type2CCS |
string |
IEC 62196-3 标准中定义的基于类型 2 的组合连接器。 该连接器基于类型 2 连接器(如 IEC 62196-2 标准所定义),另外还有两个直流 (DC) 触点,允许 DC 快速充电。 |
IEC62196Type2CableAttached |
string |
IEC 62196-2 标准中定义的类型 2 连接器。 作为连接到充电点的电缆和插头提供 |
IEC62196Type2Outlet |
string |
IEC 62196-2 标准中定义的类型 2 连接器。 作为一个插座提供给充电点。 |
IEC62196Type3 |
string |
IEC 62196-2 标准中定义的类型 3 连接器。 在原始制造商之后也称为“骗子”。 主要与高达 240V 的单相或高达 420V 的三相基础结构结合使用。 |
StandardHouseholdCountrySpecific |
string |
这些是特定区域的标准家用连接器。 它们都是交流单相以及标准电压和标准安培。 另请参阅: 插头 & 插槽类型 - 世界标准 |
Tesla |
string |
Tesla 连接器是特定于区域的特斯拉增压器连接器。 也就是说,它指的是特斯拉的专有连接器,有时称为特斯拉端口,主要限于北美或修改后的 Type 2 (DC 超过类型 2 在欧洲) 。 |
Entity
边界框的实体类型源。 对于反向地理编码,这始终等于位置。
名称 | 类型 | 说明 |
---|---|---|
position |
string |
位置实体 |
EntryPoint
要返回的 POI 的入口点。
名称 | 类型 | 说明 |
---|---|---|
position |
使用短名称“lat”&“lon”表示为纬度和经度的位置。 |
|
type |
入口点的类型。 值可以是main或次要值。 |
EntryPointType
入口点的类型。 值可以是main或次要值。
名称 | 类型 | 说明 |
---|---|---|
main |
string |
|
minor |
string |
ErrorAdditionalInfo
资源管理错误附加信息。
名称 | 类型 | 说明 |
---|---|---|
info |
object |
其他信息。 |
type |
string |
其他信息类型。 |
ErrorDetail
错误详细信息。
名称 | 类型 | 说明 |
---|---|---|
additionalInfo |
错误附加信息。 |
|
code |
string |
错误代码。 |
details |
错误详细信息。 |
|
message |
string |
错误消息。 |
target |
string |
错误目标。 |
ErrorResponse
错误响应
名称 | 类型 | 说明 |
---|---|---|
error |
错误对象。 |
GeographicEntityType
Geography 实体类型。 仅在请求 entityType 且可用时显示。
名称 | 类型 | 说明 |
---|---|---|
Country |
string |
国家/地区名称 |
CountrySecondarySubdivision |
string |
县 |
CountrySubdivision |
string |
省/市/自治区 |
CountryTertiarySubdivision |
string |
命名区域 |
Municipality |
string |
市/镇 |
MunicipalitySubdivision |
string |
Sub/Super City |
Neighbourhood |
string |
附近 |
PostalCodeArea |
string |
邮政编码/邮政编码 |
Geometry
有关结果的几何形状的信息。 仅当类型 == Geography 时才存在。
名称 | 类型 | 说明 |
---|---|---|
id |
string |
将此作为 geometryId 传递给 Get 搜索 Polygon API,以获取此结果的几何信息。 |
LatLongPairAbbreviated
使用短名称“lat”&“lon”表示为纬度和经度的位置。
名称 | 类型 | 说明 |
---|---|---|
lat |
number |
Latitude 属性 |
lon |
number |
Longitude 属性 |
LocalizedMapView
View 参数 (也称为“用户区域”参数,) 允许您为地缘政治争议区域显示特定国家/地区的正确地图。 不同的国家/地区对此类区域有不同的视图,并且 View 参数允许应用程序符合应用程序将服务的国家/地区所需的视图。 默认情况下,View 参数设置为“Unified”,即使你尚未在请求中定义它。 你有责任确定用户的位置,然后为该位置正确设置 View 参数。 或者,可以选择设置“View=Auto”,这将基于请求的 IP 地址返回地图数据。 Azure Maps 中的 View 参数的使用必须符合适用法律,包括有关地图、图像和其他数据以及你有权通过Azure Maps访问的第三方内容的国家/地区的法律。 示例:view=IN。
有关详细信息,请参阅 支持的视图 ,并查看可用的视图。
名称 | 类型 | 说明 |
---|---|---|
AE |
string |
阿拉伯联合酋长国(阿拉伯视图) |
AR |
string |
阿根廷(阿根廷视图) |
Auto |
string |
根据请求的 IP 地址返回地图数据。 |
BH |
string |
巴林(阿拉伯视图) |
IN |
string |
印度(印度视图) |
IQ |
string |
伊拉克(阿拉伯视图) |
JO |
string |
约旦(阿拉伯视图) |
KW |
string |
科威特(阿拉伯视图) |
LB |
string |
黎巴嫩(阿拉伯视图) |
MA |
string |
摩洛哥(摩洛哥视图) |
OM |
string |
阿曼(阿拉伯视图) |
PK |
string |
巴基斯坦(巴基斯坦视图) |
PS |
string |
巴勒斯坦权力机构(阿拉伯视图) |
QA |
string |
卡塔尔(阿拉伯视图) |
SA |
string |
沙特阿拉伯(阿拉伯视图) |
SY |
string |
叙利亚(阿拉伯视图) |
Unified |
string |
统一视图(其他) |
YE |
string |
也门(阿拉伯视图) |
MatchType
反向地址搜索操作的匹配类型。
名称 | 类型 | 说明 |
---|---|---|
AddressPoint |
string |
|
HouseNumberRange |
string |
|
Street |
string |
OperatingHours
POI (兴趣点) 的营业时间。
名称 | 类型 | 说明 |
---|---|---|
mode |
string |
请求中使用的值:none 或“nextSevenDays” |
timeRanges |
未来 7 天的时间范围列表 |
OperatingHoursTime
表示日期和时间
名称 | 类型 | 说明 |
---|---|---|
date |
string |
表示 POI 时区的当前日历日期,例如“2019-02-07”。 |
hour |
integer |
小时采用 POI 本地时间的 24 小时格式;可能的值为 0 - 23。 |
minute |
integer |
分钟以 POI 的本地时间表示;可能的值为 0 - 59。 |
OperatingHoursTimeRange
一天的开放时间范围
名称 | 类型 | 说明 |
---|---|---|
endTime |
给定 POI 关闭时在接下来的 7 天内的点;如果给定 POI 在范围之前关闭,则为范围的开始点。 |
|
startTime |
打开给定 POI 时在接下来的 7 天内的点;如果该范围在范围之前打开,则为范围的开头。 |
PointOfInterest
返回的 POI 的详细信息,包括姓名、电话、URL 地址和分类等信息。
名称 | 类型 | 说明 |
---|---|---|
brands |
Brand[] |
品牌数组。 返回的 POI 的品牌名称。 |
categories |
string[] |
Categories 数组 |
categorySet |
最具体的 POI 类别列表 |
|
classifications |
分类数组 |
|
name |
string |
POI 属性的名称 |
openingHours |
POI (兴趣点) 的营业时间。 |
|
phone |
string |
电话号码属性 |
url |
string |
网站 URL 属性 |
PointOfInterestCategorySet
POI 类别
名称 | 类型 | 说明 |
---|---|---|
id |
integer |
类别 ID |
QueryType
返回的查询类型:“附近”或“NON_NEAR”。
名称 | 类型 | 说明 |
---|---|---|
NEARBY |
string |
搜索是在具有定义半径的特定纬度和经度周围执行的 |
NON_NEAR |
string |
搜索是全局执行的,没有偏向于特定的纬度和经度,也没有定义的半径 |
ResponseFormat
响应的所需格式。 值可以是 json 或 xml。
名称 | 类型 | 说明 |
---|---|---|
json |
string |
|
xml |
string |
SearchAddressResult
此对象是从成功的搜索调用返回的。
名称 | 类型 | 说明 |
---|---|---|
results |
搜索 API 结果的列表。 |
|
summary |
搜索 API 响应的摘要对象 |
SearchAddressResultItem
搜索 API 响应的结果对象。
名称 | 类型 | 说明 |
---|---|---|
address |
结果的地址 |
|
addressRanges |
描述街道两侧的搜索结果的地址范围。 包括地址范围的开始和结束位置的坐标。 |
|
dataSources |
可选节。 用于获取搜索多边形 API 的引用几何 ID。 |
|
detourTime |
integer |
绕行时间(以秒为单位)。 仅对沿路由 API 的搜索调用返回。 |
dist |
number |
结果与地理偏差位置之间的直线距离(以米为单位)。 |
entityType |
Geography 实体类型。 仅在请求 entityType 且可用时显示。 |
|
entryPoints |
EntryPoint 的数组。 这些描述位置可用的入口类型。 对于前门或大厅等main入口,类型可以是“main”,对于侧门和后门,类型可以是“次要”。 |
|
id |
string |
Id 属性 |
info |
string |
有关 Result 的原始数据源的信息。 用于支持请求。 |
matchType |
有关匹配类型的信息。 下列其中一项:
|
|
poi |
返回的 POI 的详细信息,包括姓名、电话、URL 地址和分类等信息。 |
|
position |
使用短名称“lat”&“lon”表示为纬度和经度的位置。 |
|
score |
number |
结果集中的值,用于指示结果之间的相对匹配分数。 如果 x 的值为 y 的 2 倍,则可以使用它来确定结果 x 与结果 y 相关的可能性是结果 y 的两倍。 这些值因查询而异,仅用作一个结果集的相对值。 |
type |
下列其中一项:
|
|
viewport |
涵盖视区左上角和右下角坐标表示的结果的视区。 |
SearchAddressResultType
下列其中一项:
- POI
- 街道
- 地理位置
- 点地址
- 地址范围
- 十字路口
名称 | 类型 | 说明 |
---|---|---|
Address Range |
string |
|
Cross Street |
string |
|
Geography |
string |
|
POI |
string |
|
Point Address |
string |
|
Street |
string |
SearchIndexes
结果中应包含扩展邮政编码的索引。
可用索引包括:
Addr = 地址范围
Geo = Geographies
PAD = 点地址
POI = 兴趣点
Str = Streets
XStr = 十字路口 (交叉口)
值应该是以逗号分隔的索引类型列表, (以任何顺序) 或 无 索引。
默认情况下,除 Geo 之外的所有索引都包含扩展邮政编码。 地理位置的扩展邮政编码列表可能很长,因此必须在需要时显式请求它们。
用法示例:
extendedPostalCodesFor=POI
extendedPostalCodesFor=PAD,Addr,POI
extendedPostalCodesFor=None
扩展邮政编码作为地址的 extendedPostalCode 属性返回。 可用性依赖于区域。
名称 | 类型 | 说明 |
---|---|---|
Addr |
string |
|
Geo |
string |
|
PAD |
string |
|
POI |
string |
|
Str |
string |
|
Xstr |
string |
SearchSummary
搜索 API 响应的摘要对象。
名称 | 类型 | 说明 |
---|---|---|
fuzzyLevel |
integer |
提供结果所需的最大模糊级别。 |
geoBias |
指示内部搜索引擎何时应用地理空间偏差来提高结果排名。 在某些方法中,这可以通过设置 lat 和 lon 参数(如果可用)而受到影响。 在其他情况下,它纯粹是内部的。 |
|
limit |
integer |
将返回的最大响应数 |
numResults |
integer |
响应中的结果数。 |
offset |
integer |
返回的结果在完整结果集中的起始偏移量。 |
query |
string |
用于生成这些搜索结果的查询参数。 |
queryTime |
integer |
解析查询所用的时间(以毫秒为单位)。 |
queryType |
返回的查询类型:“附近”或“NON_NEAR”。 |
|
totalResults |
integer |
找到的结果总数。 |