Esta página foi traduzida pela API Cloud Translation.

Metadados de imagens do Street View

Introdução

As solicitações de metadados da API Street View Static fornecem dados sobre panoramas do Street View. Usando os metadados, você pode descobrir se uma imagem do Street View está disponível em um determinado local, além de ter acesso programático à latitude e longitude, ao ID do panorama, à data em que a foto foi tirada e às informações de direitos autorais dela. O acesso a esses metadados permite personalizar o comportamento de erros no aplicativo.

As solicitações de metadados da API Street View Static estão disponíveis sem custos financeiros. Nenhuma cota é consumida quando você solicita metadados. A cota só é consumida quando você carrega uma imagem usando a API Street View Static.

Ao fazer solicitações de metadados de imagens do Street View, as imagens do panorama são precisas em até 50 metros.

Acesso aos metadados de imagens

Uma solicitação de metadados de imagem do Street View é um URL HTTP no seguinte formato:

https://maps.googleapis.com/maps/api/streetview/metadata?parameters

Como é padrão em URLs, todos os parâmetros são separados usando o caractere "e" comercial (&).

Parâmetros obrigatórios para solicitações de metadados

As solicitações de metadados aceitam os mesmos parâmetros de URL que as solicitações de imagens da API Street View Static, embora apenas os seguintes parâmetros sejam obrigatórios:

Siga uma destas instruções:

location: pode ser uma string de texto (como Chagrin Falls, OH) ou um par de coordenadas de latitude/longitude (40.457375,-80.009353) separado por vírgulas.

ou:

pano: um ID de panorama específico. Geralmente, eles são estáveis, embora os panoramas possam mudar de ID ao longo do tempo à medida que as imagens são atualizadas.

Incluindo:

key e signature: a chave de API é necessária para autenticar a solicitação. A assinatura digital também é obrigatória em alguns casos e sempre recomendada. Para mais informações, consulte Gerar uma chave e uma assinatura.

Sua solicitação de metadados, com apenas parâmetros obrigatórios, terá esta aparência:

https://maps.googleapis.com/maps/api/streetview/metadata?location=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

ou assim:

https://maps.googleapis.com/maps/api/streetview/metadata?pano=<STRING>&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>

Parâmetros opcionais para solicitações de metadados

É possível incluir os seguintes parâmetros na solicitação de metadados: size, heading, fov e pitch. Esses parâmetros não influenciam os dados sobre o panorama nem sobre qual panorama é encontrado. A API permite a inclusão dos mesmos parâmetros que a solicitação de imagens para facilitar a criação de uma solicitação de metadados relacionada a uma solicitação de imagens específica. No entanto, para solicitações de metadados, a API ignora os parâmetros opcionais e os valores deles. Consulte o guia para desenvolvedores da API Street View Static para informações sobre como usar esses parâmetros.

Formato da resposta

As respostas de metadados são retornadas somente em formato JSON.

Exemplos

Exemplo 1: panorama encontrado

Os URLs a seguir solicitam com sucesso os metadados e a imagem do mesmo panorama.

Solicitação de metadados e resposta

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "copyright" : "© 2017 Google",
   "date" : "2016-05",
   "location" : {
      "lat" : 48.85783227207914,
      "lng" : 2.295226175151347
   },
   "pano_id" : "tu510ie_z4ptBZYo2BGEJg",
   "status" : "OK"
}

Solicitação e resposta de imagens, em que a imagem ausente é esperada.

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=eiffel%20tower,%20paris,%20france&heading=-45&pitch=42&fov=110&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Exemplo 2: panorama não encontrado

Os URLs a seguir solicitam os metadados e a imagem de um panorama que não foi encontrado no local especificado ou perto dele.

Solicitação de metadados e resposta

https://maps.googleapis.com/maps/api/streetview/metadata?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

{
   "status" : "ZERO_RESULTS"
}

Solicitação de imagens e resposta

https://maps.googleapis.com/maps/api/streetview?size=600x300&location=78.648401,14.194336&fov=90&heading=235&pitch=10&key=YOUR_API_KEY&signature=YOUR_SIGNATURE

Marcador de posição "Nenhuma imagem aqui"

Códigos de status

O campo status no objeto de resposta de metadados contém o status da solicitação e pode conter informações de depuração para ajudar a resolver o motivo pelo qual a solicitação do Street View não está funcionando. O campo status pode conter os seguintes valores:

Status	Descrição
`"OK"`	Indica que nenhum erro ocorreu; foi encontrado um panorama e os metadados são retornados.
`"ZERO_RESULTS"`	Indica que não foi encontrado um panorama perto do local fornecido. Isso pode ocorrer se um ID de panorama inexistente ou inválido for fornecido.
`"NOT_FOUND"`	Indica que a string de endereço fornecida no parâmetro `location` não foi encontrada. Isso pode acontecer se é fornecido um endereço inexistente.
`"OVER_QUERY_LIMIT"`	Indica que você excedeu a cota diária ou por segundo para essa API.
`"REQUEST_DENIED"`	Indica que a solicitação foi negada. Isso pode ocorrer se você não autorizou sua solicitação, ou se a API Street View Static não estiver ativada no projeto do console do Google Cloud que contém a chave de API.
`"INVALID_REQUEST"`	Geralmente indica que os parâmetros da consulta (address, latlng ou componentes) estão ausentes.
`"UNKNOWN_ERROR"`	Indica que a solicitação não foi processada devido a um erro de servidor. Geralmente, esse é um status temporário. Se você tentar novamente, a solicitação poderá dar certo.

Mais informações

Para mais informações sobre como usar a API Street View Static ou outros produtos da API Google Maps, consulte a página de suporte da API Maps.