Solicitação e resposta do Street View

Uma solicitação de imagem do Street View é um URL HTTP com este 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 par de coordenadas de latitude e longitude (40.457375,-80.009353), e precisam ser codificados para URL. Então, converta endereços como "Prefeitura, Nova York, NY" até "City+Hall,New+York,NY" antes de enviar a solicitação. A API Street View Static captura a foto do panorama mais próxima de o local. Quando você fornece uma string de texto de endereço, a API pode usar um local de câmera diferente para exibir melhor o local especificado. Quando você fornece coordenadas de latitude e longitude, a API procura uma foto mais próxima do local em um raio de 50 metros. Como as imagens do Street View são atualizadas periodicamente, e as fotografias podem ser tiradas de posições ligeiramente diferentes a cada vez, é possível que Seu location poderá ser capturado para um panorama diferente quando as imagens forem atualizadas.

ou:

  • pano é um ID de panorama específico. Como os panoramas podem mudar de ID ao longo do tempo, 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:

  • 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 de altura.
  • key permite que você monitore o uso da API do seu aplicativo no Console do Google Cloud, e garante que o Google possa entrar em contato com você sobre seu aplicativo, se necessário. Para saber mais, 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, o ID do panorama foi excluído e precisa ser atualizado.

  1. 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.

  2. 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

  • signature (recomendado) é uma assinatura digital usada. para verificar se os sites que geram solicitações com sua chave de API têm autorização para fazer isso. As solicitações que não incluem uma assinatura digital podem falhar. Para saber mais, consulte Gerar uma chave e uma assinatura.

    Observação: para ex-clientes do Plano Premium da Plataforma Google Maps, o cliente digital a assinatura é obrigatória. Saiba mais sobre parâmetros de autenticação para clientes do Plano Premium.

  • heading indica a direção da bússola de a câmera. Os valores aceitos são de 0 a 360 (ambos os valores indicando Norte, com 90 indicando Leste, e 180 Sul). Se você não especificar um cabeçalho, um valor será calculado que direciona a câmera na direção do location, do ponto em que a fotografia mais próxima estava tomadas.
  • fov (o padrão é 90) determina o campo de visão horizontal da imagem expresso em graus, com um valor máximo permitido de 120. Ao lidar com uma janela de visualização de tamanho fixo, como com uma imagem do Street View de uma Tamanho definido: o campo de visão representa o zoom, com números menores indicando um nível maior de zoom.


    Captura de tela de um amplo campo de visão mostrando o teto, as paredes, o chão e uma janela de tanque dentro de um aquário. Captura de tela de um campo de visão em close-up mostrando detalhes ampliados de uma foto do Street View dentro de um aquário.
    (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 Street View veículo Com frequência, mas não sempre, é o plano horizontal. Valores positivos inclinar 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, é centralizada na latitude e longitude indicadas. Os valores válidos não são negativos números inteiros.
  • return_error_code indica se a API precisa retornar um código de erro quando nenhuma imagem é encontrada (404 NÃO ENCONTRADO) ou em resposta a um solicitação inválida (400 SOLICITAÇÃO INVÁLIDA). Os valores válidos são true e false. Se definido como true, será exibida uma mensagem de erro retornada no lugar da imagem cinza genérica. Isso elimina a necessidade de faça outra chamada 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 fontes padrão para o Street View. as pesquisas não se limitam a fontes específicas.
    • outdoor: limita as pesquisas a coleções ao ar livre. Para local fechado coleções não são incluídas nos resultados da pesquisa. É possível que não existam panoramas externos para o local especificado. A pesquisa retorna apenas panoramas em que é possível determinar se estão em ambientes fechados ou ao ar livre. Por exemplo: Os PhotoSpheres não são retornados porque não se sabe se eles estão em ambientes internos ou externos.

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
Uma captura de tela de uma foto de ponto de vista no nível da rua mostrando trilhos de ferrovia eletrificada.

Nenhuma imagem disponível

Para locais onde 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 "Não temos imagens aqui.", como mostrado neste exemplo:

Uma captura de tela da imagem genérica exibida quando nenhuma imagem está disponível para o local especificado. O plano de fundo é marrom-claro e mostra o texto "Desculpe, não temos imagens aqui".
Figura: imagem genérica exibida quando não há imagens disponíveis para o em um local específico.
.

Mostrar apenas imagens válidas

Para evitar a exibição de uma imagem genérica, e verifique se sua página da Web exibir somente imagens válidas da API Street View Static, siga estas sugestões:

  • Defina o parâmetro return_error_code como true. 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 em um local específico.
  • Solicitar metadados de imagens do Street View para determinar se há imagens disponíveis para o local especificado antes para enviar uma solicitação.