Introdução
As solicitações de metadados da API Street View Static fornecem dados sobre Visualizar panoramas. Usando os metadados, você pode descobrir se uma imagem do Street View está disponível em um determinado local, além de obter acesso programático a as coordenadas de latitude e longitude, o ID do panorama, a data em que a foto tiradas e as informações de direitos autorais da imagem. Acessando este metadados permitem personalizar o comportamento de erros no aplicativo.
As solicitações de metadados da API Street View Static estão disponíveis no carga. Nenhuma cota é consumida quando você solicita metadados. A cota só é consumida quando você carrega uma imagem usando o API Street View Static.
Ao fazer solicitações de metadados de imagens do Street View, as imagens de panorama tem precisão de 50 metros.
Acessar os metadados das 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 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 os seguintes parâmetros são obrigatórios:
Siga uma destas instruções:
location
: pode ser uma string de texto (comoChagrin Falls, OH
) ou um par de coordenadas de latitude e longitude (40.457375,-80.009353
) separados por vírgula.
ou:
pano
: um ID de panorama específico. Os panoramas podem mudar os IDs ao longo do tempo. Por isso, manter esse ID. Em vez disso, salve o endereço do local ou coordenadas de latitude e longitude para atualizar o ID do panorama. Para Para mais detalhes, consulte Atualizar IDs de panoramas excluídos.
Incluindo:
key
esignature
: a chave de API é necessária para autenticar o solicitação. A assinatura digital também é obrigatória em alguns casos. sempre recomendado. Para mais informações, consulte Gerar uma chave e uma assinatura.
Sua solicitação de metadados, com apenas os parâmetros obrigatórios, tem esta aparência:
https://maps.googleapis.com/maps/api/streetview/metadata?location=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
ou assim:
https://maps.googleapis.com/maps/api/streetview/metadata?pano=&key=YOUR_API_KEY&signature=<YOUR_SIGNATURE>
Atualizar IDs de panoramas excluídos
Se você tentar recuperar um ID de panorama e receber ZERO_RESULTS
ou
nenhum valor, o ID do panorama foi excluído e precisa ser atualizado.
Salve o endereço do local ou as coordenadas de latitude e longitude que você usou receber um ID de panorama para que você possa atualizar quando necessário.
Quando você detectar que o ID de um panorama mudou, use o local original ou coordenadas de latitude e longitude para procurar novamente o panoramas para esse local e obter um novo ID de panorama.
Parâmetros opcionais para solicitações de metadados
É possível incluir os seguintes parâmetros em sua solicitação de metadados: size
,
heading
, fov
e pitch
. Esses parâmetros não influenciam
os dados sobre o panorama ou qual panorama foi encontrado.
A API permite a inclusão dos mesmos parâmetros que o
pedido de imagens
para facilitar a construção de uma solicitação de metadados relacionada a uma imagem específica
solicitação, mas para solicitações de metadados, a API ignora os parâmetros opcionais e
os valores delas. Para mais informações sobre como usar esses parâmetros, consulte a
Guia para desenvolvedores sobre a API Street View Static.
Formato da resposta
As respostas de metadados são retornadas somente em formato JSON.
Exemplos
Exemplo 1: panorama encontrado
Os URLs a seguir solicitam os metadados e a imagem do 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 encontrada no local especificado ou próximo a ele.
Solicitação e resposta de metadados
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 e resposta de imagens
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
Códigos de status
O campo status
no objeto de resposta de metadados contém o status do
a solicitação e podem conter informações de depuração para ajudar na solução de problemas
por que 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; um panorama é encontrado e os metadados são retornados. |
"ZERO_RESULTS" |
Indica que não foi encontrado um panorama perto do local fornecido. Essa resposta pode ocorrer se você fornecer um ID de panorama inexistente ou inválido. Consulte [Atualizar IDs de panoramas excluídos](#refresh-pano). |
"NOT_FOUND" |
Indica que a string de endereço fornecida no location
Não foi possível encontrar o parâmetro. Esta mensagem pode ocorrer se um endereço inexistente
é fornecida. |
"OVER_QUERY_LIMIT" |
Indica que você excedeu sua cota diária ou por segundo para esta API. |
"REQUEST_DENIED" |
Indica que a solicitação foi negada. Essa mensagem pode ocorrer se você autorize sua solicitação ou se o A API Street View Static não está ativada na Projeto do console do Google Cloud que contém sua chave de API. |
"INVALID_REQUEST" |
Geralmente indica que os parâmetros de consulta (endereço, coordenadas de latitude e longitude ou componentes) estão faltando. |
"UNKNOWN_ERROR" |
Indica que a solicitação não foi processada devido a um erro de servidor. Esse problema costuma ser 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 do Google Maps, confira a API Página de suporte.