Uma solicitação de imagem do Street View é um URL HTTP neste formato:
https://maps.googleapis.com/maps/api/streetview?parameters
A imagem é especificada usando parâmetros de solicitação. Como é padrão em URLs, todos os parâmetros são separados usando o caractere "e" comercial (&). Os parâmetros permitidos e os possíveis valores estão enumerados abaixo.
Parâmetros obrigatórios
Siga uma destas instruções:
- O
location
pode ser uma string de texto (comoChagrin Falls, OH
) ou um par de coordenadas de latitude e longitude (40.457375,-80.009353
) e precisa ser codificado em URL. Portanto, converta endereços como "City Hall, New York, NY" em "City+Hall,New+York,NY" antes de enviar a solicitação. A API Street View Static se ajusta à foto de panorama mais próxima do local. Quando você fornece uma string de texto de endereço, a API pode usar um local de câmera diferente para mostrar melhor o local especificado. Quando você fornece coordenadas de latitude e longitude, a API pesquisa um raio de 50 metros para encontrar uma foto mais próxima do local. Como as imagens do Street View são atualizadas periodicamente, e as fotos podem ser tiradas de posições ligeiramente diferentes a cada vez, é possível que alocation
use um panorama diferente quando as imagens forem atualizadas.
ou:
pano
é um ID de panorama específico. Os panoramas podem mudar o ID ao longo do tempo. Por isso, não mantenha esse ID. Salve o endereço do local ou as coordenadas de latitude e longitude para atualizar o ID do panorama. Veja mais detalhes em Atualizar IDs de panoramas excluídos.
Incluindo:
size
especifica o tamanho de saída da imagem em pixels. O tamanho é especificado como{width}x{height}
. Por exemplo,size=600x400
retorna uma imagem com 600 pixels de largura e 400 pixels de altura.key
permite monitorar o uso da API do aplicativo no Console do Google Cloud e garante que o Google possa entrar em contato com você sobre o aplicativo, se necessário. Para ver mais informações, consulte Gerar uma chave e uma assinatura.
Atualizar IDs de panoramas excluídos
Se você tentar recuperar um ID de panorama e receber ZERO_RESULTS
ou nenhum valor, isso significa que o ID foi excluído e precisa ser atualizado.
Salve o endereço do local ou as coordenadas de latitude e longitude que você usou para receber um ID de panorama e atualize quando necessário.
Quando você detectar que um ID de panorama foi alterado, use o endereço do local original ou as coordenadas de latitude e longitude para procurar novamente os panoramas mais próximos desse local e conseguir um novo ID.
Parâmetros opcionais
signature
(recomendado) é uma assinatura digital usada para verificar se os sites que geram solicitações usando sua chave de API estão autorizados a fazer isso. As solicitações que não incluem uma assinatura digital podem falhar. Para ver mais informações, consulte Gerar uma chave e uma assinatura.Observação: para antigos clientes do Plano Premium da Plataforma Google Maps, a assinatura digital é obrigatória. Confira mais informações sobre os parâmetros de autenticação para clientes do Plano Premium.
heading
indica a direção da bússola da câmera. Os valores aceitos são de0
a360
(ambos os valores indicando Norte, com90
indicando Leste e180
sul). Se você não especificar uma direção, será calculado um valor que direciona a câmera para olocation
especificado a partir do ponto em que a foto mais próxima foi tirada.fov
(o padrão é90
) determina o campo de visão horizontal da imagem expresso em graus, com um valor máximo permitido de120
. Ao lidar com uma janela de visualização de tamanho fixo, assim como com uma imagem do Street View de tamanho definido, o campo de visão basicamente representa o zoom, com números menores indicando um nível maior de zoom.
(esquerda:fov=120
; direita:fov=20
)pitch
(o padrão é0
) especifica o ângulo para cima ou para baixo da câmera em relação ao veículo do Street View. Com frequência, mas não sempre, é o plano horizontal. Os valores positivos levam o ângulo da câmera para cima (com90
graus indicando diretamente para cima). Os valores negativos levam o ângulo da câmera para baixo (com-90
indicando diretamente para baixo).radius
(o padrão é50
) define um raio, especificado em metros, para pesquisar um panorama, centralizado na latitude e longitude indicadas. Os valores válidos são números inteiros não negativos.return_error_code
indica se a API retornará um código de erro quando nenhuma imagem for encontrada (404 NOT FOUND) ou em resposta a uma solicitação inválida (400 BAD REQUEST). Os valores válidos sãotrue
efalse
. Se definido comotrue
, uma mensagem de erro será retornada no lugar da imagem cinza genérica. Isso elimina a necessidade de fazer uma chamada separada para verificar a disponibilidade da imagem.source
(o padrão édefault
) limita as pesquisas do Street View às origens selecionadas. Os valores válidos são:default
usa as fontes padrão do Street View. As pesquisas não se limitam a fontes específicas.outdoor
: limita as pesquisas a coleções ao ar livre. Coleções internas não são incluídas nos resultados da pesquisa. e pode ser que não existam panoramas externos para o local especificado. A pesquisa só retorna panoramas quando é possível determinar se eles estão em um ambiente fechado ou ao ar livre. Por exemplo, PhotoSpheres não são retornados porque não se sabe se eles estão em ambientes fechados ou ao ar livre.
Este é um exemplo de solicitação.
https://maps.googleapis.com/maps/api/streetview?size=600x300&location=46.414382,10.013988&heading=151.78&pitch=-0.76&key=YOUR_API_KEY&signature=YOUR_SIGNATURE
Nenhuma imagem disponível
Para locais em que as imagens do Street View não estão disponíveis, a API Street View Static retorna uma imagem cinza genérica com o texto "Infelizmente não temos imagens aqui", conforme mostrado neste exemplo:
Mostrar apenas imagens válidas
Para evitar a exibição de uma imagem genérica e garantir que sua página da Web mostre apenas imagens válidas da API Street View Static, siga estas sugestões:
- Defina o parâmetro
return_error_code
comotrue
. Isso faz com que a API Street View Static retorne um erro 404 NÃO ENCONTRADO no lugar da imagem cinza genérica, se nenhuma imagem estiver disponível para o local especificado. - Antes de enviar uma solicitação, solicite metadados de imagem do Street View para determinar se há imagens disponíveis para o local especificado.