Search - Get Search Nearby
Use para buscar puntos de interés cerca de una ubicación específica.
La Get Search Nearby
API es una solicitud HTTP GET
más útil para recuperar resultados de PUNTOS de interés en torno a una ubicación específica. Este punto de conexión solo devolverá resultados de POI y no tendrá en cuenta ningún parámetro de consulta de búsqueda.
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}
Parámetros de identificador URI
Nombre | En | Requerido | Tipo | Description |
---|---|---|---|---|
format
|
path | True |
Formato deseado de la respuesta. El valor puede ser json o xml. |
|
api-version
|
query | True |
string |
Número de versión de la API de Azure Maps. |
lat
|
query | True |
number double |
Latitud en la que los resultados deben estar sesgados. Por ejemplo, 37.337. |
lon
|
query | True |
number double |
Longitud en la que los resultados deben estar sesgados. Por ejemplo, -121,89. |
brand
|
query |
string[] |
Lista separada por comas de nombres de marca que se podrían usar para restringir el resultado a marcas específicas. No importa el orden de los elementos. Cuando se proporcionan varias marcas, solo se devolverán los resultados que pertenecen a (al menos) una de las listas proporcionadas. Las marcas que contienen un elemento "," en su nombre deben incluirse entre comillas. Ejemplos de uso: brandSet=Foo brandSet=Foo,Bar brandSet="A,B,C Coma",Bar |
|
category
|
query |
integer[] |
Lista separada por comas de identificadores de conjuntos de categorías que se podrían usar para restringir el resultado a categorías específicas de puntos de interés. El orden de identificación no importa. El número máximo de
|
|
connector
|
query |
Lista separada por comas de tipos de conectores que se podrían usar para restringir el resultado a la estación de vehículos eléctricos que admita tipos de conector específicos. No importa el orden de los elementos. Cuando se proporcionan varios tipos de conectores, solo se devolverán los resultados que pertenecen a (al menos) una de las listas proporcionadas. Los tipos de conector disponibles son:
Ejemplos de uso: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached |
||
country
|
query |
string[] |
Cadena separada por comas de códigos de país o región, por ejemplo, FR,ES. Esto limitará la búsqueda a los países o regiones especificados. |
|
extended
|
query |
Índices para los que se deben incluir códigos postales extendidos en los resultados. Los índices disponibles son: Addr = Intervalos de direcciones Geo = Geographies PAD = Direcciones de punto POI = Puntos de interés Str = Calles XStr = Cross Streets (intersecciones) El valor debe ser una lista separada por comas de tipos de índice (en cualquier orden) o None para ningún índice. De forma predeterminada, se incluyen códigos postales extendidos para todos los índices excepto Geo. Las listas de códigos postales extendidas para las zonas geográficas pueden ser bastante largas, por lo que deben solicitarse explícitamente cuando sea necesario. Ejemplos de uso: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None El código postal extendido se devuelve como una propiedad extendedPostalCode de una dirección. La disponibilidad depende de la región. |
||
language
|
query |
string |
Idioma en el que se deben devolver los resultados de búsqueda. Debe ser una de las etiquetas de lenguaje IETF admitidas, sin distinción entre mayúsculas y minúsculas. Cuando los datos del idioma especificado no están disponibles para un campo específico, se usa el idioma predeterminado. Consulte Idiomas admitidos para obtener más información. |
|
limit
|
query |
integer |
Número máximo de respuestas que se devolverán. Valor predeterminado: 10, mínimo: 1 y máximo: 100 |
|
ofs
|
query |
integer |
Desplazamiento inicial de los resultados devueltos dentro del conjunto de resultados completo. Valor predeterminado: 0 |
|
radius
|
query |
integer |
El radio en metros a para que los resultados se restrinjan al área definida, el valor mínimo es 1, el valor máximo es 50000. |
|
view
|
query |
El parámetro View (también denominado parámetro "región de usuario") le permite mostrar los mapas correctos para un determinado país o región para regiones controvertidas geopolíticamente. Los distintos países o regiones tienen vistas diferentes de estas regiones y el parámetro View permite que la aplicación cumpla con la vista requerida por el país o región que la aplicación va a atender. De forma predeterminada, el parámetro View se establece en "Unificado", incluso si no lo ha definido en la solicitud. Es su responsabilidad determinar la ubicación de sus usuarios y luego establecer el parámetro Vista correctamente para esa ubicación. Como alternativa, tiene la opción de establecer "View=Auto", que devolverá los datos del mapa según la dirección IP de la solicitud. El parámetro View de Azure Maps debe usarse de conformidad con las leyes aplicables, incluidas las relativas a la asignación, del país o región en el que están disponibles mapas, imágenes y otros datos y contenido de terceros a los que está autorizado a acceder a través de Azure Maps. Ejemplo: view=IN. Consulte Vistas admitidas para obtener más información y para ver las vistas disponibles. |
Encabezado de la solicitud
Nombre | Requerido | Tipo | Description |
---|---|---|---|
x-ms-client-id |
string |
Especifica qué cuenta está pensada para su uso junto con el modelo de seguridad de Microsoft Entra ID. Representa un identificador único para la cuenta de Azure Maps y se puede recuperar de la API de cuenta del plano de administración de Azure Maps. Para usar Microsoft Entra ID seguridad en Azure Maps consulte los siguientes artículos para obtener instrucciones. |
Respuestas
Nombre | Tipo | Description |
---|---|---|
200 OK |
Aceptar |
|
Other Status Codes |
Se ha producido un error inesperado. |
Seguridad
AADToken
Estos son los flujos de OAuth 2.0 de Microsoft Entra. Cuando se empareja con el control de acceso basado en rol de Azure, se puede usar para controlar el acceso a Azure Maps API REST. Los controles de acceso basados en roles de Azure se usan para designar el acceso a una o varias Azure Maps cuenta de recursos o subrecursos. A cualquier usuario, grupo o entidad de servicio se le puede conceder acceso a través de un rol integrado o un rol personalizado compuesto por uno o varios permisos para Azure Maps API REST.
Para implementar escenarios, se recomienda ver los conceptos de autenticación. En resumen, esta definición de seguridad proporciona una solución para el modelado de aplicaciones a través de objetos capaces de controlar el acceso en determinadas API y ámbitos.
Nota
- Esta definición de seguridad requiere el uso del
x-ms-client-id
encabezado para indicar a qué recurso Azure Maps la aplicación solicita acceso. Esto se puede adquirir desde la API de administración de Maps . -
Authorization URL
es específico de la instancia de nube pública de Azure. Las nubes soberanas tienen direcciones URL de autorización únicas y configuraciones de Microsoft Entra ID. - El control de acceso basado en rol de Azure se configura desde el plano de administración de Azure mediante Azure Portal, PowerShell, la CLI, los SDK de Azure o las API REST.
- El uso del SDK web de Azure Maps permite la configuración basada en la configuración de una aplicación para varios casos de uso.
- Para obtener más información sobre Plataforma de identidad de Microsoft, consulte introducción a Plataforma de identidad de Microsoft.
Tipo:
oauth2
Flujo:
implicit
Dirección URL de autorización:
https://login.microsoftonline.com/common/oauth2/authorize
Ámbitos
Nombre | Description |
---|---|
https://atlas.microsoft.com/.default | https://atlas.microsoft.com/.default |
subscription-key
Se trata de una clave compartida que se aprovisiona al crear una cuenta de Azure Maps en el Azure Portal o mediante PowerShell, la CLI, los SDK de Azure o la API REST.
Con esta clave, cualquier aplicación puede acceder a todas las API REST. En otras palabras, esta clave se puede usar como clave maestra en la cuenta en la que se emiten.
En el caso de las aplicaciones expuestas públicamente, nuestra recomendación es usar el enfoque de aplicaciones cliente confidenciales para acceder a Azure Maps API REST para que la clave se pueda almacenar de forma segura.
Tipo:
apiKey
En:
query
SAS Token
Se crea un token de firma de acceso compartido a partir de la operación List SAS en el recurso de Azure Maps a través del plano de administración de Azure a través de Azure Portal, PowerShell, CLI, SDK de Azure o API REST.
Con este token, cualquier aplicación está autorizada para acceder a los controles de acceso basado en rol de Azure y el control específico a la expiración, la tasa y las regiones de uso para el token determinado. En otras palabras, el token de SAS se puede usar para permitir que las aplicaciones controlen el acceso de forma más segura que la clave compartida.
En el caso de las aplicaciones expuestas públicamente, nuestra recomendación es configurar una lista específica de orígenes permitidos en el recurso de la cuenta de asignación para limitar la representación del abuso y renovar periódicamente el token de SAS.
Tipo:
apiKey
En:
header
Ejemplos
Search for any points of interest (POI) within 5 miles of Manhattan NY and return the top 10 results
Solicitud de ejemplo
GET https://atlas.microsoft.com/search/nearby/json?api-version=1.0&lat=40.70627&lon=-74.011454&limit=10&radius=8046
Respuesta de muestra
{
"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
}
}
]
}
]
}
Definiciones
Nombre | Description |
---|---|
Address |
Dirección del resultado |
Address |
Describe el intervalo de direcciones en ambos lados de la calle para obtener un resultado de búsqueda. Se incluyen las coordenadas de las ubicaciones inicial y final del intervalo de direcciones. |
Bounding |
Ventanilla que cubre el resultado representado por las coordenadas superior izquierda e inferior derecha de la ventanilla. |
Bounding |
Cuadro de límite de la ubicación. |
Brand |
La marca asociada a la POI |
Classification |
Clasificación de la POI que se devuelve |
Classification |
Nombre de la clasificación |
Data |
Sección opcional. Identificadores de referencia para su uso con get Búsqueda Polygon API. |
Electric |
Lista separada por comas de tipos de conectores que se podrían usar para restringir el resultado a la estación de vehículos eléctricos que admite tipos de conector específicos. No importa el orden de los elementos. Cuando se proporcionan varios tipos de conectores, solo se devolverán los resultados que pertenecen a (al menos) una de las listas proporcionadas. Los tipos de conector disponibles son:
Ejemplos de uso: connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached |
Entity |
Origen del tipo de entidad del rectángulo de selección. Para la geocodificación inversa, siempre es igual a la posición. |
Entry |
Punto de entrada para el PUNTO de interés que se devuelve. |
Entry |
Tipo de punto de entrada. El valor puede ser principal o secundario. |
Error |
Información adicional sobre el error de administración de recursos. |
Error |
Detalle del error. |
Error |
Respuesta de error |
Geographic |
Tipo de entidad Geography. Solo se presenta cuando se solicitó entityType y está disponible. |
Geometry |
Información sobre la forma geométrica del resultado. Solo está presente si el tipo == Geography. |
Lat |
Una ubicación representada como una latitud y longitud con nombres cortos "lat" & "lon". |
Localized |
El parámetro View (también denominado parámetro "región de usuario") le permite mostrar los mapas correctos para un determinado país o región para regiones controvertidas geopolíticamente. Los distintos países o regiones tienen vistas diferentes de estas regiones y el parámetro View permite que la aplicación cumpla con la vista requerida por el país o región que la aplicación va a atender. De forma predeterminada, el parámetro View se establece en "Unificado", incluso si no lo ha definido en la solicitud. Es su responsabilidad determinar la ubicación de sus usuarios y luego establecer el parámetro Vista correctamente para esa ubicación. Como alternativa, tiene la opción de establecer "View=Auto", que devolverá los datos del mapa según la dirección IP de la solicitud. El parámetro View de Azure Maps debe usarse de conformidad con las leyes aplicables, incluidas las relativas a la asignación, del país o región en el que están disponibles mapas, imágenes y otros datos y contenido de terceros a los que está autorizado a acceder a través de Azure Maps. Ejemplo: view=IN. Consulte Vistas admitidas para obtener más información y para ver las vistas disponibles. |
Match |
Tipos de coincidencias para una operación de búsqueda de direcciones inversas. |
Operating |
Horario de apertura de un POI (Puntos de interés). |
Operating |
Representa una fecha y hora |
Operating |
Intervalo de tiempo de apertura para un día |
Point |
Detalles de la POI devuelta, incluida la información como el nombre, el teléfono, la dirección URL y las clasificaciones. |
Point |
Categoría poi |
Query |
Tipo de consulta que se devuelve: NEARBY o NON_NEAR. |
Response |
Formato deseado de la respuesta. El valor puede ser json o xml. |
Search |
Este objeto se devuelve de una llamada de Búsqueda correcta. |
Search |
Objeto result para una respuesta de API de Búsqueda. |
Search |
Uno de los valores siguientes:
|
Search |
Índices para los que se deben incluir códigos postales extendidos en los resultados. Los índices disponibles son: Addr = Intervalos de direcciones Geo = Geographies PAD = Direcciones de punto POI = Puntos de interés Str = Calles XStr = Calles cruzadas (intersecciones) El valor debe ser una lista separada por comas de tipos de índice (en cualquier orden) o None para ningún índice. De forma predeterminada, los códigos postales extendidos se incluyen para todos los índices excepto Geo. Las listas de códigos postales extendidos para zonas geográficas pueden ser bastante largas, por lo que deben solicitarse explícitamente cuando sea necesario. Ejemplos de uso: extendedPostalCodesFor=POI extendedPostalCodesFor=PAD,Addr,POI extendedPostalCodesFor=None El código postal extendido se devuelve como una propiedad extendedPostalCode de una dirección. La disponibilidad depende de la región. |
Search |
Objeto summary para una respuesta de api de Búsqueda. |
Address
Dirección del resultado
Nombre | Tipo | Description |
---|---|---|
boundingBox |
Cuadro de límite de la ubicación. |
|
buildingNumber |
string |
Número de edificio en la calle. EN DESUSO, use streetNumber en su lugar. |
country |
string |
nombre de país o región |
countryCode |
string |
País (Nota: Se trata de un código de dos letras, no un nombre de país o región). |
countryCodeISO3 |
string |
Código de país ISO alfa-3 |
countrySecondarySubdivision |
string |
County |
countrySubdivision |
string |
Estado o provincia |
countrySubdivisionCode |
string |
|
countrySubdivisionName |
string |
Nombre completo de un primer nivel de jerarquía administrativa de país o región. Este campo solo aparece en caso de que countrySubdivision se presente en forma abreviada. Solo se admite para ESTADOS UNIDOS, Canadá y Reino Unido. |
countryTertiarySubdivision |
string |
Área con nombre |
crossStreet |
string |
Nombre de la calle que se cruza. |
extendedPostalCode |
string |
Código postal extendido (la disponibilidad depende de la región). |
freeformAddress |
string |
Una línea de direcciones con formato según las reglas de formato del país o región de origen de un resultado, o en el caso de un país o región, su nombre completo de país o región. |
localName |
string |
Componente de dirección que representa el nombre de un área geográfica o localidad que agrupa varios objetos direccionables con fines de direccionamiento, sin ser una unidad administrativa. Este campo se usa para compilar la |
municipality |
string |
Ciudad/Ciudad |
municipalitySubdivision |
string |
Sub/Super City |
neighbourhood |
string |
Un barrio es una zona geográficamente localizada dentro de una ciudad o ciudad con características distintivas e interacciones sociales entre los habitantes. |
postalCode |
string |
Código postal/código postal |
routeNumbers |
string[] |
Los códigos usados para identificar inequívocamente la calle |
street |
string |
Nombre de la calle. EN DESUSO, use streetName en su lugar. |
streetName |
string |
Nombre de la calle. |
streetNameAndNumber |
string |
Nombre y número de la calle. |
streetNumber |
string |
Número de edificio en la calle. |
AddressRanges
Describe el intervalo de direcciones en ambos lados de la calle para obtener un resultado de búsqueda. Se incluyen las coordenadas de las ubicaciones inicial y final del intervalo de direcciones.
Nombre | Tipo | Description |
---|---|---|
from |
Una ubicación representada como latitud y longitud con nombres cortos "lat" & "lon". |
|
rangeLeft |
string |
Intervalo de direcciones en el lado izquierdo de la calle. |
rangeRight |
string |
Intervalo de direcciones en el lado derecho de la calle. |
to |
Una ubicación representada como latitud y longitud con nombres cortos "lat" & "lon". |
BoundingBox
Ventanilla que cubre el resultado representado por las coordenadas superior izquierda e inferior derecha de la ventanilla.
Nombre | Tipo | Description |
---|---|---|
btmRightPoint |
Una ubicación representada como latitud y longitud con nombres cortos "lat" & "lon". |
|
topLeftPoint |
Una ubicación representada como latitud y longitud con nombres cortos "lat" & "lon". |
BoundingBoxCompassNotation
Cuadro de límite de la ubicación.
Nombre | Tipo | Description |
---|---|---|
entity |
Origen del tipo de entidad del rectángulo de selección. Para la geocodificación inversa, siempre es igual a la posición. |
|
northEast |
string |
Latitud norte-este,coordenada de longitud del rectángulo delimitador como floats separados por comas |
southWest |
string |
Latitud sur-oeste, coordenada de longitud del rectángulo delimitador como floats separados por comas |
Brand
La marca asociada a la POI
Nombre | Tipo | Description |
---|---|---|
name |
string |
Nombre de la marca |
Classification
Clasificación de la POI que se devuelve
Nombre | Tipo | Description |
---|---|---|
code |
string |
Propiedad code |
names |
Matriz de nombres |
ClassificationName
Nombre de la clasificación
Nombre | Tipo | Description |
---|---|---|
name |
string |
Name (propiedad) |
nameLocale |
string |
Name Locale (propiedad) |
DataSources
Sección opcional. Identificadores de referencia para su uso con get Búsqueda Polygon API.
Nombre | Tipo | Description |
---|---|---|
geometry |
Información sobre la forma geométrica del resultado. Solo está presente si el tipo == Geography. |
ElectricVehicleConnector
Lista separada por comas de tipos de conectores que se podrían usar para restringir el resultado a la estación de vehículos eléctricos que admite tipos de conector específicos. No importa el orden de los elementos. Cuando se proporcionan varios tipos de conectores, solo se devolverán los resultados que pertenecen a (al menos) una de las listas proporcionadas.
Los tipos de conector disponibles son:
-
StandardHouseholdCountrySpecific
- Estos son los conectores domésticos estándar para una determinada región. Todas son ac de una sola fase y el voltaje estándar y el amperaje estándar. Consulte también: Plug & socket types - World Standards. -
IEC62196Type1
- Conector de tipo 1 tal y como se define en la norma IEC 62196-2. También se llama Yazaki después del fabricante original o SAE J1772 después del estándar que lo publicó por primera vez. Se usa principalmente en combinación con la infraestructura de una sola fase de 120V o de hasta 240V. -
IEC62196Type1CCS
- Conector combinado basado en tipo 1 tal y como se define en la norma IEC 62196-3. El conector se basa en el conector type 1 , tal y como se define en el estándar IEC 62196-2, con dos contactos adicionales de corriente directa (DC) para permitir la carga rápida del controlador de dominio. -
IEC62196Type2CableAttached
- Conector de tipo 2 tal y como se define en la norma IEC 62196-2. Proporcionado como cable y conectado al punto de carga. -
IEC62196Type2Outlet
- Conector de tipo 2 tal y como se define en la norma IEC 62196-2. Se proporciona como un socket establecido en el punto de carga. -
IEC62196Type2CCS
- Conector combinado basado en tipo 2 tal y como se define en la norma IEC 62196-3. El conector se basa en el conector type 2 , tal y como se define en el estándar IEC 62196-2, con dos contactos adicionales de corriente directa (DC) para permitir la carga rápida del controlador de dominio. -
IEC62196Type3
- Conector de tipo 3 tal como se define en el estándar IEC 62196-2. También llamado Scame después del fabricante original. Se usa principalmente en combinación con una sola fase de hasta 240V o hasta una infraestructura de tres fases de hasta 420V. -
Chademo
- Conector CHAdeMO denominado después de una asociación formada por tokyo Electric Power Company y socios industriales. Debido a esto, también se conoce como el conector de TEPCO. Es compatible con la carga rápida de DC. -
IEC60309AC1PhaseBlue
- El conector Industrial Blue es un conector definido en el estándar IEC 60309. En algún momento se conoce como por alguna combinación del estándar, el color y el hecho de que es un conector de fase única. Normalmente, el conector tiene la configuración "P+N+E, 6h". -
IEC60309DCWhite
- El conector blanco industrial es un conector dc definido en el estándar IEC 60309. -
Tesla
- El conector Tesla es el conector Tesla Supercharger específico regionalmente. Es decir, se refiere al conector propietario de Tesla, a veces denominado Tesla Port principalmente limitado a Norteamérica o al tipo 2 modificado en Europa.
Ejemplos de uso:
connectorSet=IEC62196Type2CableAttached connectorSet=IEC62196Type2Outlet,IEC62196Type2CableAttached
Nombre | Tipo | Description |
---|---|---|
Chademo |
string |
Conector CHAdeMO denominado después de una asociación formada por tokyo Electric Power Company y socios industriales. Debido a esto, también se conoce como el conector de TEPCO. Es compatible con la carga rápida de DC. |
IEC60309AC1PhaseBlue |
string |
El conector Industrial Blue es un conector definido en el estándar IEC 60309. En algún momento se conoce como por alguna combinación del estándar, el color y el hecho de que es un conector de fase única. Normalmente, el conector tiene la configuración "P+N+E, 6h". |
IEC60309DCWhite |
string |
El conector Industrial White es un conector dc definido en el estándar IEC 60309. |
IEC62196Type1 |
string |
Conector de tipo 1 tal y como se define en el estándar IEC 62196-2. También se llama Yazaki después del fabricante original o SAE J1772 después del estándar que lo publicó por primera vez. Se usa principalmente en combinación con la infraestructura de una sola fase de 120V o de hasta 240V. |
IEC62196Type1CCS |
string |
Conector combinado basado en tipo 1 tal y como se define en el estándar IEC 62196-3. El conector se basa en el conector type 1 , tal y como se define en el estándar IEC 62196-2, con dos contactos adicionales de corriente directa (DC) para permitir la carga rápida del controlador de dominio. |
IEC62196Type2CCS |
string |
Conector combinado basado en tipo 2 tal y como se define en el estándar IEC 62196-3. El conector se basa en el conector type 2 , tal y como se define en el estándar IEC 62196-2, con dos contactos adicionales de corriente directa (DC) para permitir la carga rápida del controlador de dominio. |
IEC62196Type2CableAttached |
string |
Conector de tipo 2 tal y como se define en el estándar IEC 62196-2. Proporcionado como cable y conectado al punto de carga |
IEC62196Type2Outlet |
string |
Conector de tipo 2 tal y como se define en el estándar IEC 62196-2. Se proporciona como un socket establecido en el punto de carga. |
IEC62196Type3 |
string |
Conector de tipo 3 tal y como se define en la norma IEC 62196-2. También llamado Scame después del fabricante original. Se usa principalmente en combinación con una sola fase de hasta 240V o hasta una infraestructura de tres fases de hasta 420V. |
StandardHouseholdCountrySpecific |
string |
Estos son los conectores domésticos estándar para una determinada región. Todas son ac de una sola fase y el voltaje estándar y el amperaje estándar. Vea también: Plug & socket types - World Standards |
Tesla |
string |
El conector Tesla es el conector Tesla Supercharger específico regionalmente. Es decir, se refiere al conector propietario de Tesla, a veces denominado Tesla Port principalmente limitado a Norteamérica o al tipo 2 modificado en Europa. |
Entity
Origen del tipo de entidad del rectángulo de selección. Para la geocodificación inversa, siempre es igual a la posición.
Nombre | Tipo | Description |
---|---|---|
position |
string |
Entidad position |
EntryPoint
Punto de entrada para el PUNTO de interés que se devuelve.
Nombre | Tipo | Description |
---|---|---|
position |
Una ubicación representada como latitud y longitud con nombres cortos "lat" & "lon". |
|
type |
Tipo de punto de entrada. El valor puede ser principal o secundario. |
EntryPointType
Tipo de punto de entrada. El valor puede ser principal o secundario.
Nombre | Tipo | Description |
---|---|---|
main |
string |
|
minor |
string |
ErrorAdditionalInfo
Información adicional sobre el error de administración de recursos.
Nombre | Tipo | Description |
---|---|---|
info |
object |
Información adicional. |
type |
string |
Tipo de información adicional. |
ErrorDetail
Detalle del error.
Nombre | Tipo | Description |
---|---|---|
additionalInfo |
Información adicional del error. |
|
code |
string |
Código de error. |
details |
Los detalles del error. |
|
message |
string |
El mensaje de error. |
target |
string |
Destino del error. |
ErrorResponse
Respuesta de error
Nombre | Tipo | Description |
---|---|---|
error |
Objeto de error. |
GeographicEntityType
Tipo de entidad Geography. Solo se presenta cuando se solicitó entityType y está disponible.
Nombre | Tipo | Description |
---|---|---|
Country |
string |
nombre de país o región |
CountrySecondarySubdivision |
string |
County |
CountrySubdivision |
string |
Estado o provincia |
CountryTertiarySubdivision |
string |
Área con nombre |
Municipality |
string |
Ciudad/Ciudad |
MunicipalitySubdivision |
string |
Sub/Super City |
Neighbourhood |
string |
Barrio |
PostalCodeArea |
string |
Código postal/código postal |
Geometry
Información sobre la forma geométrica del resultado. Solo está presente si el tipo == Geography.
Nombre | Tipo | Description |
---|---|---|
id |
string |
Pase esto como geometryId a get Búsqueda Polygon API para capturar información de geometría para este resultado. |
LatLongPairAbbreviated
Una ubicación representada como una latitud y longitud con nombres cortos "lat" & "lon".
Nombre | Tipo | Description |
---|---|---|
lat |
number |
Latitude (propiedad) |
lon |
number |
Longitud (propiedad) |
LocalizedMapView
El parámetro View (también denominado parámetro "región de usuario") le permite mostrar los mapas correctos para un determinado país o región para regiones controvertidas geopolíticamente. Los distintos países o regiones tienen vistas diferentes de estas regiones y el parámetro View permite que la aplicación cumpla con la vista requerida por el país o región que la aplicación va a atender. De forma predeterminada, el parámetro View se establece en "Unificado", incluso si no lo ha definido en la solicitud. Es su responsabilidad determinar la ubicación de sus usuarios y luego establecer el parámetro Vista correctamente para esa ubicación. Como alternativa, tiene la opción de establecer "View=Auto", que devolverá los datos del mapa según la dirección IP de la solicitud. El parámetro View de Azure Maps debe usarse de conformidad con las leyes aplicables, incluidas las relativas a la asignación, del país o región en el que están disponibles mapas, imágenes y otros datos y contenido de terceros a los que está autorizado a acceder a través de Azure Maps. Ejemplo: view=IN.
Consulte Vistas admitidas para obtener más información y para ver las vistas disponibles.
Nombre | Tipo | Description |
---|---|---|
AE |
string |
Emiratos Árabes Unidos (vista árabe) |
AR |
string |
Argentina (vista argentina) |
Auto |
string |
Devuelva los datos del mapa según la dirección IP de la solicitud. |
BH |
string |
Baréin (vista árabe) |
IN |
string |
India (vista india) |
IQ |
string |
Irak (vista árabe) |
JO |
string |
Jordania (vista árabe) |
KW |
string |
Kuwait (vista árabe) |
LB |
string |
Líbano (vista árabe) |
MA |
string |
Marruecos (vista marroquí) |
OM |
string |
Omán (vista árabe) |
PK |
string |
Pakistán (vista pakistaní) |
PS |
string |
Autoridad Nacional Palestina (vista árabe) |
QA |
string |
Catar (vista árabe) |
SA |
string |
Arabia Saudí (vista árabe) |
SY |
string |
Siria (vista árabe) |
Unified |
string |
Vista unificada (otros) |
YE |
string |
Yemen (vista árabe) |
MatchType
Tipos de coincidencias para una operación de búsqueda de direcciones inversas.
Nombre | Tipo | Description |
---|---|---|
AddressPoint |
string |
|
HouseNumberRange |
string |
|
Street |
string |
OperatingHours
Horario de apertura de un POI (Puntos de interés).
Nombre | Tipo | Description |
---|---|---|
mode |
string |
Valor usado en la solicitud: none o "nextSevenDays" |
timeRanges |
Lista de intervalos de tiempo para los próximos 7 días |
OperatingHoursTime
Representa una fecha y hora
Nombre | Tipo | Description |
---|---|---|
date |
string |
Representa la fecha actual del calendario en la zona horaria poi, por ejemplo, "2019-02-07". |
hour |
integer |
Las horas tienen el formato de 24 horas en la hora local de un POI; los valores posibles son 0 - 23. |
minute |
integer |
Los minutos se encuentran en la hora local de un POI; los valores posibles son 0 - 59. |
OperatingHoursTimeRange
Intervalo de tiempo de apertura para un día
Nombre | Tipo | Description |
---|---|---|
endTime |
El punto en el intervalo de 7 días siguiente cuando se cierra una poi determinada, o el principio del intervalo si se cerró antes del intervalo. |
|
startTime |
El punto en el intervalo de 7 días siguiente cuando se abre una poi determinada, o el principio del intervalo si se abrió antes del intervalo. |
PointOfInterest
Detalles de la POI devuelta, incluida la información como el nombre, el teléfono, la dirección URL y las clasificaciones.
Nombre | Tipo | Description |
---|---|---|
brands |
Brand[] |
Matriz de marcas. Nombre de la marca para la poi que se va a devolver. |
categories |
string[] |
Matriz de categorías |
categorySet |
Lista de las categorías de POI más específicas |
|
classifications |
Matriz de clasificación |
|
name |
string |
Nombre de la propiedad POI |
openingHours |
Horario de apertura de un POI (Puntos de interés). |
|
phone |
string |
Propiedad de número de teléfono |
url |
string |
Propiedad URL del sitio web |
PointOfInterestCategorySet
Categoría poi
Nombre | Tipo | Description |
---|---|---|
id |
integer |
Id. de categoría |
QueryType
Tipo de consulta que se devuelve: NEARBY o NON_NEAR.
Nombre | Tipo | Description |
---|---|---|
NEARBY |
string |
Búsqueda se realizó alrededor de una determinada latitud y longitud con un radio definido |
NON_NEAR |
string |
Búsqueda se realizó globalmente, sin sesgos en una determinada latitud y longitud, y sin radio definido |
ResponseFormat
Formato deseado de la respuesta. El valor puede ser json o xml.
Nombre | Tipo | Description |
---|---|---|
json |
string |
Formato de intercambio de datos de notación de objetos JavaScript |
xml |
string |
SearchAddressResult
Este objeto se devuelve de una llamada de Búsqueda correcta.
Nombre | Tipo | Description |
---|---|---|
results |
Lista de resultados de la API de Búsqueda. |
|
summary |
Objeto summary para una respuesta de api de Búsqueda |
SearchAddressResultItem
Objeto result para una respuesta de API de Búsqueda.
Nombre | Tipo | Description |
---|---|---|
address |
Dirección del resultado |
|
addressRanges |
Describe el intervalo de direcciones en ambos lados de la calle para obtener un resultado de búsqueda. Se incluyen las coordenadas de las ubicaciones inicial y final del intervalo de direcciones. |
|
dataSources |
Sección opcional. Id. de geometría de referencia para su uso con get Búsqueda Polygon API. |
|
detourTime |
integer |
Tiempo de desvío en segundos. Solo se devuelve para las llamadas a Búsqueda Along Route API. |
dist |
number |
Distancia recta entre el resultado y la ubicación de geobias en metros. |
entityType |
Tipo de entidad Geography. Solo se presenta cuando se solicitó entityType y está disponible. |
|
entryPoints |
Matriz de EntryPoints. Los que describen los tipos de entradas disponibles en la ubicación. El tipo puede ser "main" para las entradas principales, como una puerta principal, o un vestíbulo, y "menor", para puertas laterales y traseras. |
|
id |
string |
Propiedad Id |
info |
string |
Información sobre el origen de datos original del resultado. Se usa para solicitudes de soporte técnico. |
matchType |
Información sobre el tipo de coincidencia. Uno de los valores siguientes:
|
|
poi |
Detalles de la POI devuelta, incluida la información como el nombre, el teléfono, la dirección URL y las clasificaciones. |
|
position |
Una ubicación representada como una latitud y longitud con nombres cortos "lat" & "lon". |
|
score |
number |
Valor de un conjunto de resultados para indicar la puntuación de coincidencia relativa entre los resultados. Puede usarlo para determinar que el resultado x es el doble de probabilidad de ser tan relevante como resultado y si el valor de x es 2x el valor de y. Los valores varían entre las consultas y solo está pensado como un valor relativo para un conjunto de resultados. |
type |
Uno de los valores siguientes:
|
|
viewport |
Ventanilla que cubre el resultado representado por las coordenadas superior izquierda e inferior derecha de la ventanilla. |
SearchAddressResultType
Uno de los valores siguientes:
- POI
- Calle
- Geography
- Dirección del punto
- Intervalo de direcciones
- Cruce
Nombre | Tipo | Description |
---|---|---|
Address Range |
string |
|
Cross Street |
string |
|
Geography |
string |
|
POI |
string |
|
Point Address |
string |
|
Street |
string |
SearchIndexes
Índices para los que se deben incluir códigos postales extendidos en los resultados.
Los índices disponibles son:
Addr = Intervalos de direcciones
Geo = Geographies
PAD = Direcciones de punto
POI = Puntos de interés
Str = Calles
XStr = Calles cruzadas (intersecciones)
El valor debe ser una lista separada por comas de tipos de índice (en cualquier orden) o None para ningún índice.
De forma predeterminada, los códigos postales extendidos se incluyen para todos los índices excepto Geo. Las listas de códigos postales extendidos para zonas geográficas pueden ser bastante largas, por lo que deben solicitarse explícitamente cuando sea necesario.
Ejemplos de uso:
extendedPostalCodesFor=POI
extendedPostalCodesFor=PAD,Addr,POI
extendedPostalCodesFor=None
El código postal extendido se devuelve como una propiedad extendedPostalCode de una dirección. La disponibilidad depende de la región.
Nombre | Tipo | Description |
---|---|---|
Addr |
string |
|
Geo |
string |
|
PAD |
string |
|
POI |
string |
|
Str |
string |
|
Xstr |
string |
SearchSummary
Objeto summary para una respuesta de api de Búsqueda.
Nombre | Tipo | Description |
---|---|---|
fuzzyLevel |
integer |
Nivel máximo aproximado necesario para proporcionar resultados. |
geoBias |
Indicación de cuándo el motor de búsqueda interno ha aplicado un sesgo geoespacial para mejorar la clasificación de los resultados. En algunos métodos, esto puede verse afectado estableciendo los parámetros lat y lon cuando están disponibles. En otros casos es puramente interno. |
|
limit |
integer |
Número máximo de respuestas que se devolverán |
numResults |
integer |
Número de resultados en la respuesta. |
offset |
integer |
Desplazamiento inicial de los resultados devueltos dentro del conjunto de resultados completo. |
query |
string |
Parámetro de consulta que se usó para generar estos resultados de búsqueda. |
queryTime |
integer |
Tiempo dedicado a resolver la consulta, en milisegundos. |
queryType |
Tipo de consulta que se devuelve: NEARBY o NON_NEAR. |
|
totalResults |
integer |
Número total de resultados encontrados. |