Metadados de imagens do Street View

Introdução

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

As solicitações de metadados da API Street View Static estão disponíveis sem custo financeiro. 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 têm 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 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, mas apenas os seguintes parâmetros são 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 e longitude separadas por vírgula (40.457375,-80.009353).

ou:

• pano: um ID de panorama específico. Os panoramas podem mudar de ID com o tempo, então não persista esse ID. Em vez disso, salve o endereço do local ou as coordenadas de latitude e longitude para atualizar o ID do panorama. Para detalhes, consulte Atualizar IDs de panorama excluídos.

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 Receber uma chave e uma assinatura.

A 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 foi excluído e precisa ser atualizado.

1. Salve o endereço do local ou as coordenadas de latitude e longitude usadas para receber um ID de panorama e atualizar quando necessário.

2. Quando você detectar que um ID de panorama mudou, use o endereço ou as coordenadas de latitude e longitude do local original para pesquisar novamente os panoramas mais próximos e receber um novo ID.

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 qual panorama é encontrado. A API permite a inclusão dos mesmos parâmetros da 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. Para informações sobre como usar esses parâmetros, consulte o guia do desenvolvedor da 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 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 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 da solicitação e pode incluir informações de depuração para ajudar a resolver o problema de funcionamento da solicitação do Street View. O campo status pode conter os seguintes valores:

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.