Solicitação e resposta do Street View

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:

• location pode ser uma string de texto (como Chagrin Falls, OH) ou um valor de latitude/longitude (40.457375,-80.009353) e precisa ser codificada em URL. Portanto, endereços como "City Hall, New York, NY" precisam ser convertidos em "City+Hall,New+York,NY" antes da assinatura da solicitação. A API Street View Static se ajustará ao panorama fotografado mais próximo deste local. Quando uma string de texto de endereço é fornecida, a API pode usar um local de câmera diferente para exibir melhor o local especificado. Quando uma latitude/longitude é fornecida, a API procura um raio de 50 metros em busca de uma foto mais próxima desse local. Como as imagens do Street View são atualizadas periodicamente e as fotos podem ser tiradas de posições um pouco diferentes a cada vez, é possível que o location ajuste um panorama diferente quando as imagens forem atualizadas.

ou:

• pano é um ID de panorama específico. Eles são geralmente estáveis.

Incluindo:

• size especifica o tamanho da 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 de altura.
• key permite monitorar o uso da API do seu aplicativo no Console do Google Cloud e garante que o Google possa entrar em contato com você sobre o aplicativo, se necessário. Para mais informações, consulte Receber uma chave e uma assinatura.

Parâmetros opcionais

• signature (recomendado) é uma assinatura digital usada para verificar se qualquer site que gere solicitações usando sua chave de API tem autorização para isso. As solicitações que não incluem uma assinatura digital podem falhar. Para mais informações, consulte Receber uma chave e uma assinatura.

  Observação:para antigos clientes do Plano Premium da Plataforma Google Maps, a assinatura digital é obrigatória. Veja mais informações sobre parâmetros de autenticação para clientes do plano Premium.

• heading indica a direção da bússola da câmera. Os valores aceitos vão de 0 a 360 (ambos os valores indicam norte, com 90 indicando leste e 180 sul). Se nenhum título for especificado, um valor será calculado para direcionar a câmera para o location 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. O campo de visão é expresso em graus, com um valor máximo permitido de 120. Ao lidar com uma janela de visualização de tamanho fixo, como uma imagem do Street View de um tamanho definido, o campo de visão basicamente representa o zoom, com números menores que indicam um nível maior de zoom.

  
  
  (Esquerda: fov=120; Direito: 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. Valores positivos inclinam a câmera para cima, com 90 graus indicando diretamente para cima. Valores negativos inclinam a câmera para baixo (com -90 indicando para baixo).
• radius (o padrão é 50) define um raio, especificado em metros, no qual pesquisar um panorama, centralizado na latitude e longitude fornecidas. Os valores válidos são números inteiros não negativos.
• return_error_code indica se a API precisa 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ão true e false. Se definido como true, 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 fontes selecionadas. Os valores válidos são:
  • default usa as origens padrão do Street View. As pesquisas não são limitadas a origens 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. Os panoramas externos não existem para o local especificado. A pesquisa retorna apenas panoramas quando for possível determinar se eles estão dentro ou fora de casa. Por exemplo, o PhotoSpheres não é retornado porque é desconhecido se ele está dentro ou fora de casa.

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 cinza com o texto "Não temos imagens aqui", conforme mostrado neste exemplo:

Mostrar apenas imagens válidas

Para evitar a exibição da imagem genérica e garantir que sua página da Web exiba apenas imagens válidas da API Street View Static, siga estas sugestões:

• Defina o parâmetro return_error_code como true. Isso fará com que a API Street View Static retorne um erro 404 NOT FOUND em vez da imagem cinza genérica, caso nenhuma imagem esteja disponível para o local especificado.
• Solicite os metadados de imagem do Street View para determinar se há imagens disponíveis para o local especificado antes de enviar uma solicitação.