Method: resolveMapsUrls

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

Solicitud HTTP

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

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 
{
  "urls": [
    string
  ]
}
Campos
urls[]

string

Obligatorio. Son las URLs de Google Maps que se resolverán. Cada URL debe ser una URL válida de Google Maps, por ejemplo, https://maps.app.goo.gl/..., https://www.google.com/maps/place/... o https://maps.google.com/.... Actualmente, solo se admiten URLs que dirigen a un solo lugar. Puedes especificar hasta 20 URLs.

Cuerpo de la respuesta

Es el mensaje de respuesta para v1alpha.resolveMapsUrls.

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

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

object (Entity)

Solo salida. Es la lista de entidades resueltas a partir de las URLs de Google Maps. Se garantiza que la asignación es de 1:1 con los índices de urls de la solicitud. Un mensaje vacío en el índice i (en el que no se establece ningún entity) indica que no se pudo resolver esa URL. Si la resolución falló, verifica el campo failedRequests para conocer el estado del error.
failedRequests

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

Solo salida. Es un mapa que comunica las fallas parciales de las URLs de Google Maps. La clave es el índice de la solicitud fallida en el campo urls. 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