Blocos do Street View

Blocos do Street View são semelhantes aos blocos 2D, exceto pelo fato de terem imagens panorâmicas tiradas no nível da rua. Com o Street View, você pode explorar pontos turísticos no mundo todo, ver belezas naturais e entrar em lugares como museus, estádios, restaurantes ou pequenas empresas. Esse endpoint de API dá acesso a:

• Blocos do Street View do Google Maps
• Metadados do Street View
• Miniaturas do Street View

Você pode unir blocos de imagens retirados da rua para criar um efeito panorâmico real. Além disso, você pode consultar até 100 IDs de panorama para um conjunto de locais (como um trajeto) e receber metadados mais detalhados sobre a posição da câmera.

É preciso ter um leitor para unir os blocos do Street View. Por exemplo, o visualizador de panoramas personalizados do Street View.

Dica :para mais informações, consulte API Street View Static e Serviço Street View.

Quando você tiver uma chave de API, siga as etapas abaixo para acessar as imagens do Street View.

1. Receber um token de sessão. Defina o valor de mapType como streetview.

2. Use o token de sessão para conferir o identificador do panorama (panoId) de um ou mais locais geográficos.

3. Use os identificadores do panorama da resposta da pesquisa "panoId" para conseguir:

   1. Metadados do Street View. Você também pode acessar os metadados do Street View transmitindo um conjunto de coordenadas e um raio.

   2. Miniaturas do Street View.

   3. Blocos do Street View.

Observação :você precisa mostrar informações de direitos autorais em todos os panoramas do Street View. A string a ser exibida pode variar entre os panoramas. Para receber informações de direitos autorais, solicite os metadados do Street View. Em seguida, consulte o campo copyright da resposta.

Métodos do Street View

É possível acessar imagens e metadados do Street View chamando um dos quatro métodos a seguir.

Método	Descrição
https://tile.googleapis.com/v1/streetview/tiles	Retorna os blocos individuais do Street View. Você pode recuperar blocos do Street View em seis níveis de zoom: de 512 a 13.312 pixels.
https://tile.googleapis.com/v1/streetview/panoIds	Permite pesquisar até 100 locais em massa. Retorna IDs de panorama para todos os locais com imagens.
https://tile.googleapis.com/v1/streetview/thumbnail	Retorna uma imagem JPEG em miniatura de uma cena do Street View. Permite informar título, inclinação, dimensões e campo de visão. As dimensões mínimas são 16 x 16 pixels. As dimensões máximas são 250 x 600 pixels.
https://tile.googleapis.com/v1/streetview/metadata	Fornece informações detalhadas sobre o panorama especificado. Os detalhes incluem o endereço relacionado e links para panoramas adjacentes.

Pesquisa de panoIds do Street View

Para encontrar o identificador do panorama de um ou mais locais geográficos, transmita as coordenadas (lat, lng) para o método panoIds. O corpo da solicitação é um objeto JSON que contém uma matriz locations e, opcionalmente, radius, conforme mostrado no exemplo de código JSON a seguir.

curl -X POST -d '{
  "locations": [
    {"lat": -33.883837, "lng": 151.209307},
    {"lat": -33.883700, "lng": 151.210307},
    {"lat": 0, "lng": 0}
  ],
  "radius": 50
}' \
-H 'Content-Type: application/json' \
"https://tile.googleapis.com/v1/streetview/panoIds?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY"

locations

A matriz locations precisa conter pelo menos um conjunto de valores de coordenadas, mas é possível incluir mais (até 100).

radius

O valor radius (medido em metros) define o raio do círculo ao redor do local especificado para pesquisar panoramas. O valor padrão é 50 metros.

Resposta do panoId

A API Map Tiles tenta encontrar o panorama mais próximo de cada local e, em seguida, retorna os IDs de panorama. Uma solicitação panoIds bem-sucedida retorna um objeto JSON que contém uma matriz panoIds. A matriz contém uma lista de IDs de panorama, na ordem em que você os solicitou. Se a API Map Tiles não encontrar panoramas para os locais solicitados, uma string vazia vai ser retornada nesse local da matriz. Para conferir um exemplo, consulte o código JSON a seguir.

{
  "panoIds": [
    "ACfH-n2HcBvRry_3oc9grw",
    "f5DJZatBAAAXHlooS2wKbw",
    ""
  ]
}

Você pode usar panoIds para:

• Solicitar metadados do Street View
• Solicitar miniaturas do Street View
• Solicitar blocos do Street View

Observação :os IDs de panorama são temporários. Ou seja, não duram muito tempo. Como regra geral, não espere que os IDs de panorama sejam válidos por mais do que uma única sessão de usuário.

Metadados do Street View

As solicitações de metadados do Street View recuperam informações sobre panoramas. Uma solicitação de metadados do Street View é uma solicitação HTTPS GET. É possível recuperar informações sobre panoramas de duas maneiras:

• Se você transmitir um pano_id, a API Map Tiles vai retornar os metadados desse panorama.

• No entanto, se você transmitir lat e lng, a API Map Tiles vai retornar os metadados do panorama mais próximo dentro do raio de pesquisa especificado.

Transmitir um conjunto de coordenadas e um raio

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&lat=lat&lng=lng&radius=meters"

Como os IDs dos panoramas são temporários, recomendamos que você transmita um conjunto de coordenadas e um valor radius na solicitação inicial de metadados do Street View. Confira um exemplo no snippet de código a seguir.

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&lat=47.62066&lng=-122.34923&radius=50"

Transmitir o panoId de uma imagem do Street View

curl "https://tile.googleapis.com/v1/streetview/metadata?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId"

Resposta de metadados

O código JSON a seguir é um exemplo de uma resposta típica de metadados.

{
 "panoId": "rZ9KeTyhA11i0VppYNzsSg",
 "lat": 37.420864219339165,
 "lng": -122.08446528377291,
 "imageHeight": 6656,
 "imageWidth": 13312,
 "tileHeight": 512,
 "tileWidth": 512,
 "heading": 94.35,
 "tilt": 88.39652,
 "roll": 1.7181772,
 "imageryType": "outdoor",
 "date": "2023-01",
 "copyright": "© 2023 Google",
 "reportProblemLink": "https://cbks0.googleapis.com/cbk?output=report&panoid=rZ9KeTyhA11i0VppYNzsSg&cb_client=api&cbp=1,0,,0,0&hl=en-US&gl=us",
 "addressComponents": [
  {
   "longName": "United States",
   "shortName": "United States",
   "types": [
    "country"
   ]
  },
  {
   "longName": "Mountain View, California",
   "shortName": "Mountain View, California",
   "types": [
    "locality"
   ]
  },
  {
   "longName": "Charleston Rd",
   "shortName": "Charleston Rd",
   "types": [
    "route"
   ]
  },
  {
   "longName": "1635",
   "shortName": "1635",
   "types": [
    "street_number"
   ]
  }
 ],
 "links": [
  {
   "panoId": "Yw4pqzA4FEq1qs-BwZSvSQ",
   "heading": 274.47998046875,
   "text": "Charleston Rd"
  },
  {
   "panoId": "1cODYwFRw1aZ45IignDIMw",
   "heading": 94.47999572753906,
   "text": "Charleston Rd"
  }
 ]
}

A lista a seguir contém definições dos campos no corpo da resposta.

panoId

O ID exclusivo deste panorama. Não é recomendável que os IDs de panoramas sejam válidos por mais tempo do que uma única sessão de usuário.

lat, lng

As coordenadas (latitude e longitude) do panorama. Esses valores podem ser diferentes das coordenadas transmitidas na solicitação porque o local é correspondente ao panorama mais próximo.

imageHeight, imageWidth

As dimensões da imagem do panorama costurado.

tileHeight, tileWidth

As dimensões de um único bloco do panorama.

heading

A direção da bússola, medida em graus, no sentido horário a partir do Norte. Os títulos são retornados dentro do intervalo [0,360], e 0 representa o norte.

tilt

A inclinação do panorama, medida em graus do polo sul do panorama até o horizonte. Os valores retornados estão dentro do intervalo [0, 180]. Um valor de 90 graus indica que o horizonte já está alinhado no equador do panorama.

roll

A rotação no sentido horário ao redor da linha de visão que foi aplicada ao panorama para nivelar o horizonte. Os valores retornados estão dentro do intervalo [0, 360].

imageryType

Indica o tipo de imagem. Os valores válidos são indoor e outdoor.

date

A data em que a imagem foi tirada. Nem todas as imagens têm dados de data. Mas, quando estiver disponível, esse campo conterá uma combinação do ano (AAAA) e do mês (MM). Por exemplo: 2023-05 ou 2024.

copyright

O texto de direitos autorais que precisa ser mostrado como atribuição junto com a imagem do Street View.

reportProblemLink

Um hiperlink para seus usuários usarem para informar problemas com este bloco do Street View. É necessário exibir esse hiperlink no canto inferior direito da imagem. Ele precisa incluir um texto de link que diga algo como "Informar um problema com esta imagem".

addressComponent

Um geocódigo estruturado com detalhes sobre o endereço do panorama. Para mais informações, consulte Solicitações e respostas Geocoding na documentação da API Geocoding.

links

Uma lista de IDs de panorama vinculados a este. Também contém o cabeçalho em que o link é encontrado. Por exemplo, se a direção for 180°, o panorama vinculado fica ao sul do panorama atual. Devido à natureza temporária dos IDs de panoramas, não dependa deles para mais do que uma única sessão de usuário.

Miniaturas do Street View

Você pode solicitar imagens do Street View no formato thumbnail. Miniaturas são imagens sem blocos com tamanho, cabeçalho, inclinação e campo de visão definidos pelo usuário. As imagens em miniatura têm uma resolução menor que blocos e são menores em arquivos. Você faz uma solicitação de miniatura enviando uma solicitação GET para o endpoint thumbnail, conforme demonstrado no protótipo de código a seguir.

Observação: os valores de campo entre colchetes neste exemplo mostram intervalos. Por exemplo, height pode variar de 16 a 250 pixels.

curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId&height=FROM_16_TO_250&width=FROM_16_TO_600&pitch=FROM-90_TO_90&yaw=FROM-360_TO_360&fov=FROM_30_TO_120"

Considere o exemplo de código a seguir, que faz o download de uma miniatura de imagens do Street View tiradas em Whistler, Canadá.

curl "https://tile.googleapis.com/v1/streetview/thumbnail?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=Zzl28rqGJgaL2IdkUleP8A&height=200&width=200&pitch=0&yaw=250&fov=80" --output /tmp/example_thumbnail.png

Parâmetros obrigatórios

panoId

O ID exclusivo da miniatura que você quer usar. Acesse os valores de ID do panorama usando os endpoints panoIds ou metadata. Ambos aceitam coordenadas geográficas e retornam o panoId apropriado.

session

Um token de sessão válido.

key

Sua chave de API.

Parâmetros opcionais

height

Especifica a altura da miniatura em pixels, variando de 16 a 250 pixels. Se você não especificar uma altura, ela será padronizada com o valor máximo permitido de 250 pixels. Se você especificar um valor fora do intervalo, a miniatura será ajustada para o valor válido mais próximo.

width

Especifica a largura da miniatura em pixels, variando de 16 a 600 pixels. Se você não especificar uma largura, ela será padronizada com o valor máximo permitido de 600 pixels. Se você especificar um valor fora do intervalo, a miniatura será ajustada ao valor válido mais próximo.

pitch

Especifica o ângulo da câmera ao longo do eixo vertical. Os valores válidos estão no intervalo de -90 a 90 (inclusive). O valor padrão é 0.

yaw

Especifica a direção da câmera ao longo do eixo horizontal. Os valores válidos estão no intervalo de -360 a 360 (inclusive). O valor padrão é 0.

fov

Especifica o campo de visão horizontal, expresso em graus, com um valor máximo de 120. Ao lidar com uma janela de visualização de tamanho fixo, como em uma imagem do Street View de tamanho definido, o campo de visão representa o zoom. Valores menores especificam um nível maior de zoom. O valor padrão é 90.

Blocos de imagem do Street View

Quando você tiver uma panoId, poderá solicitar um bloco de imagem do Street View. As solicitações de bloco são solicitações HTTPS GET. Considere este exemplo.

curl "https://tile.googleapis.com/v1/streetview/tiles/z/x/y?session=YOUR_SESSION_TOKEN&key=YOUR_API_KEY&panoId=panoId"

Neste exemplo de código, z é o nível de zoom, e x e y são as coordenadas do bloco do Street View que você quer. Os níveis de zoom nos panoramas do Street View precisam estar no intervalo [0,5], e 0 representa o campo de visão mais amplo.

Nível de zoom	Campo de visão aproximado
0	360°
1	180°
2	90°
3	7°
4	22,5°
5	11,25°

Observação: as imagens do Street View têm duas origens. A primeira é o Google (imagens não públicas controladas pelo desenvolvedor) e a segunda é o público (UGC, ou Conteúdo público gerado pelo usuário). Não há como usar apenas uma fonte de imagens do Street View. Saiba mais sobre nossa Política de Privacidade sobre imagens do Street View.

Respostas do Street View Tiles

Uma solicitação de bloco do Street View bem-sucedida retorna uma imagem no formato e tamanho especificados na resposta createSession.

No nível de zoom zero, o panorama inteiro é redimensionado em um bloco com as dimensões tileWidth por tileHeight. Como os panoramas são maiores na dimensão x, o bloco conterá um espaço vazio na dimensão y:

No nível de zoom cinco, o panorama em tamanho original é usado e dividido em blocos.

Dica :é possível calcular os valores máximos de x e y dividindo imageHeight e imageWidth pelo tileHeight e tileWidth.

Informações sobre direitos autorais

É necessário exibir informações de direitos autorais em todos os panoramas do Street View. A string a ser exibida pode variar entre os panoramas. Para conferir as informações de direitos autorais, solicite os metadados do Street View e consulte o campo copyright da resposta. Para mais informações, consulte Atribuições de dados.