Method: resolveNames

Resuelve una lista de nombres de lugares (o direcciones) en entidades geoespaciales específicas (p.ej., lugares) en Google Maps.

Solicitud HTTP

POST https://mapstools.googleapis.com/v1alpha:resolveNames

La URL usa la sintaxis de la transcodificación de gRPC.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "queries": [
    {
      object (LocationQuery)
    }
  ],
  "locationBias": {
    object (LocationBias)
  },
  "regionCode": string
}
Campos
queries[]

object (LocationQuery)

Obligatorio. Es una lista de búsquedas de ubicación que se resolverán. Puedes especificar hasta 20 búsquedas.
locationBias

object (LocationBias)

Opcional. Es una región opcional para sesgar los resultados de la resolución. Si se especifica, los resultados de la resolución se sesgarán hacia las entidades que estén más cerca de esta región. Incluir locationBias o regionCode suele proporcionar mejores resultados, ya que reduce el espacio de búsqueda.

Si se especifican locationBias y regionCode, locationBias tiene prioridad sobre regionCode.
regionCode

string

Opcional. Es un código de región opcional para sesgar los resultados de la resolución. Si se especifica, los resultados de la resolución se sesgarán hacia las entidades que se encuentren en la región especificada o cerca de ella. Debe ser un código de región CLDR. Por ejemplo, "US" o "CA". Incluir locationBias o regionCode suele proporcionar mejores resultados, ya que reduce el espacio de búsqueda.

Si se especifican locationBias y regionCode, locationBias tiene prioridad sobre regionCode.

Cuerpo de la respuesta

Es el mensaje de respuesta para v1alpha.resolveNames.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "results": [
    {
      object (Result)
    }
  ],
  "failedRequests": {
    integer: {
      object (Status)
    },
    ...
  }
}
Campos
results[]

object (Result)

Solo salida. Es la lista de entidades resueltas a partir de las búsquedas de ubicación. Se garantiza que se correlacionarán 1:1 con los índices de queries de la solicitud. Una cadena vacía en el índice i indica que falló la resolución para esa búsqueda. Si la resolución falló, verifica el campo failedRequests para conocer el estado del error.
failedRequests

map (key: integer, value: object (Status))

Solo salida. Mapa que comunica fallas parciales. La clave es el índice de la solicitud fallida en el campo queries. El valor es el estado de error que detalla por qué falló la resolución.

Un objeto que contiene una lista de pares "key": value. Ejemplo: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/maps-platform.mapstools
  • https://www.googleapis.com/auth/cloud-platform.read-only

LocationQuery

Una búsqueda de ubicación representa una entidad de ubicación específica que se puede resolver con Google Maps. Actualmente, solo se admiten los nombres de lugares y las direcciones como búsquedas de ubicación.

Representación JSON 
{
  "text": string
}
Campos
text

string

Obligatorio. Es la búsqueda de texto que se resuelve en una entidad geoespacial específica en Google Maps, como un lugar o una dirección. Cuanto más específica sea la consulta, más precisa será la resolución. Por ejemplo, "San Francisco", "Googleplex, Mountain View, CA", "1600 Amphitheatre Parkway, Mountain View, CA" o "Torre Eiffel, París". Las búsquedas deben ser una dirección o el nombre de un lugar específicos. No se admiten ubicaciones generales, como el nombre de una cadena (p.ej., Starbucks) o una búsqueda como "restaurantes".

LocationBias

Es la región para sesgar los resultados de la resolución.

Representación JSON 
{

  // Union field type can be only one of the following:
  "viewport": {
    object (Viewport)
  }
  // End of list of possible types for union field type.
}
Campos
Campo de unión type. Es el tipo de sesgo de ubicación. type puede ser solo uno de los parámetros siguientes:
viewport

object (Viewport)

Es un viewport definido por un cuadro delimitador.

Viewport

Es una ventana gráfica de latitud y longitud, representada como dos puntos low y high opuestos diagonalmente. Un viewport se considera una región cerrada, es decir, incluye su límite. Los límites de latitud deben estar entre -90 y 90 grados inclusive, y los límites de longitud deben estar entre -180 y 180 grados inclusive. Entre los diversos casos, se incluyen los siguientes:

  • Si low = high, el viewport consta de ese único punto.

  • Si low.longitude > high.longitude, el rango de longitud se invierte (el viewport cruza la línea de longitud de 180 grados).

  • Si low.longitude = -180 grados y high.longitude = 180 grados, la ventana gráfica incluye todas las longitudes.

  • Si low.longitude = 180 grados y high.longitude = -180 grados, el rango de longitud está vacío.

  • Si low.latitude > high.latitude, el rango de latitud está vacío.

Se deben completar low y high, y el cuadro representado no puede estar vacío (como se especifica en las definiciones anteriores). Un viewport vacío generará un error.

Por ejemplo, este viewport encierra completamente la ciudad de Nueva York:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Representación JSON 
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Campos
low

object (LatLng)

Obligatorio. Es el punto más bajo de la ventana gráfica.
high

object (LatLng)

Obligatorio. Es el punto más alto de la ventana gráfica.

LatLng

Es un objeto que representa un par de valores de latitud y longitud. Esto se expresa como un par de números de punto flotante de doble precisión que representan los grados de latitud y longitud. A menos que se especifique lo contrario, este objeto debe cumplir con el estándar WGS84. Los valores deben pertenecer a rangos normalizados.

Representación JSON 
{
  "latitude": number,
  "longitude": number
}
Campos
latitude

number

La latitud expresada en grados. Debe pertenecer al rango [-90.0, +90.0].
longitude

number

La longitud expresada en grados. Debe pertenecer al rango [-180.0, +180.0].

Resultado

Es una sola entidad resuelta a partir de una consulta de ubicación determinada, junto con el nivel de confianza de la resolución.

Representación JSON 
{
  "entity": {
    object (Entity)
  },
  "confidence": enum (Confidence)
}
Campos
entity

object (Entity)

Solo salida. Es la entidad resuelta a partir de la búsqueda de ubicación.
confidence

enum (Confidence)

Solo salida. Es el nivel de confianza de la resolución.

Confianza

Es el nivel de confianza de la resolución.

Enums
CONFIDENCE_UNSPECIFIED Valor predeterminado Este valor no se usa.
MEDIUM La confianza media indica que es probable que la resolución sea correcta, pero puede haber otros candidatos.
HIGH Un nivel de confianza alto indica que la resolución es correcta y representa una entidad geoespacial específica (p.ej., un lugar específico).