Google Street View Image API

Introdução

A Google Street View Image API permite que você incorpore um panorama ou uma miniatura estática (não interativa) do Street View em sua página sem precisar usar JavaScript. A porta de visualização é definida com parâmetros de URL enviados por meio de uma solicitação HTTP padrão e é retornada como uma imagem estática.

Os aplicativos de exemplo podem não estar disponíveis para sua região.

https://maps.googleapis.com/maps/api/streetview?size=400x400&location=40.720032,-73.988354
&fov=90&heading=235&pitch=10
&key=YOUR_API_KEY

Parâmetros de URL

Uma solicitação da Street View Image API é um URL HTTP no seguinte 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

Uma das possibilidades:

• location pode ser uma string de texto (como Chagrin Falls, OH) ou um valor de latitude/longitude (40.457375,-80.009353). A Google Street View Image API direcionará para o panorama fotografado mais próximo da localização em questão. 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 um par de latitude/longitude é fornecido, a API procura em um raio de 50 metros uma fotografia mais próxima a esse local. Como as imagens do Street View são atualizadas periodicamente e as fotografias podem ser tiradas de posições ligeiramente diferentes cada vez, é possível que o location passe para um panorama quando as imagens forem atualizadas.

Ou:

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

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 aplicativo no Google API Console, permite o acesso a uma boa cota diária gratuita e garante que a Google possa contatar você para falar sobre o aplicativo, se necessário. Para saber mais, consulte Obter uma chave e uma assinatura.

  Observação: clientes Google Maps APIs Premium Plan podem usar uma chave de API e uma assinatura digital ou um ID de cliente válido e uma assinatura digital nas solicitações do Street View. Saiba mais sobre parâmetros de autenticação para clientes Premium Plan.

  Clientes com uma licença antiga do Google Maps APIs for Work devem incluir parâmetros client e signature válidos com as solicitações, em vez de key. Para obter mais informações, consulte a seção IDs de cliente e assinaturas da página "Obter uma chave e uma assinatura".

Parâmetros opcionais

• signature (recomendado) é uma assinatura digital usada para confirmar que qualquer site que gere solicitações usando sua chave de API tenha autorização para fazê-lo. Observação: Se você ativar a cobrança, a assinatura digital é obrigatória. Se você exceder o limite diário gratuito de carregamentos de mapa, precisará pagar por carregamentos adicionais para o restante do dia. Carregamentos de mapa pagos que não têm assinatura digital não funcionam. Para saber mais, consulte Obter uma chave e uma assinatura.

  Observação: para clientes do Google Maps APIs Premium Plan, a assinatura digital é obrigatória. Saiba mais sobre parâmetros de autenticação para clientes Premium Plan.

• heading indica a direção da bússola da câmera. Os valores aceitos se encaixam na faixa entre 0 e 360 (ambos os valores indicam o norte, com 90 indicando leste e 180 sul). Se nenhuma direção for especificada, um valor será calculado para direcionar a câmera para o location especificado a partir do ponto no qual a fotografia mais próxima foi tirada.
• fov (o valor padrão é 90) determina o campo de visão horizontal da imagem. O campo de visão é expressado em graus e o valor máximo permitido é 120. Ao trabalhar com uma porta 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)

  Os aplicativos de exemplo podem não estar disponíveis para sua região.

• pitch (o valor padrão é 0) especifica o ângulo superior ou inferior 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 um ângulo perpendicular), enquanto que valores negativos a inclinam para baixo (com -90 graus indicando um ângulo perpendicular).

Veja abaixo 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

Os aplicativos de exemplo podem não estar disponíveis para sua região.

Nenhuma imagem disponível

Para locais em que imagens do Street View não estão disponíveis, a Google Street View Image API retorna uma imagem cinza genérica com o texto "Sorry, we have no imagery here".

Figura: Imagem genérica quando nenhuma imagem está disponível para o local especificado.

Os aplicativos de exemplo podem não estar disponíveis para sua região.

Para evitar esse cenário, você pode determinar se há imagens disponíveis para o local especificado, bem como outros dados sobre a imagem, solicitando metadados de imagem do Street View.

Mais informações

Para saber mais sobre como usar a Google Street View Image API ou outros produtos de Google Maps APIs, consulte a página de Suporte das Maps APIs.