Em breve, a Plataforma Google Maps usará a nova estilização de mapas. Essa atualização inclui uma nova paleta de cores padrão e melhorias nas experiências de mapa e na usabilidade. Todos os estilos de mapa serão atualizados automaticamente em março de 2025. Para mais informações sobre a disponibilidade e como ativar logo, consulte Novo estilo de mapa para a Plataforma Google Maps.

Esta página foi traduzida pela API Cloud Translation.

Rendering

StreetViewPanorama aula

Classe google.maps.StreetViewPanorama

Mostra o panorama de um determinado LatLng ou ID do panorama. Um objeto StreetViewPanorama fornece um "visualizador" do Street View que pode ser independente dentro de um <div> separado ou vinculado a um Map.

Essa classe estende MVCObject:

Acesse chamando const {StreetViewPanorama} = await google.maps.importLibrary("streetView"). Consulte Bibliotecas na API Maps JavaScript.

Construtor
`StreetViewPanorama`	`StreetViewPanorama(container[, opts])` Parâmetros: `container`: `HTMLElement` `opts`: `StreetViewPanoramaOptions optional` Cria um panorama com o `StreetViewPanoramaOptions` transmitido.

Propriedades
`controls`	Tipo: `Array<MVCArray<HTMLElement>>` Controles adicionais a serem adicionados ao panorama. Para adicionar um controle ao panorama, adicione o `<div>` do controle ao `MVCArray` correspondente ao `ControlPosition` em que ele será renderizado.

Métodos
`focus`	`focus()` Parâmetros: nenhum Valor de retorno: nenhum Define o foco para este `StreetViewPanorama`. Considere usar esse método com um evento `visible_changed` para garantir que `StreetViewPanorama` esteja visível antes de definir o foco nele. Uma `StreetViewPanorama` que não é visível não pode ser focada.
`getLinks`	`getLinks()` Parâmetros: nenhum Valor de retorno: `Array<StreetViewLink>` Retorna o conjunto de links de navegação para o panorama do Street View.
`getLocation`	`getLocation()` Parâmetros: nenhum Valor de retorno: `StreetViewLocation` Retorna o StreetViewLocation do panorama atual.
`getMotionTracking`	`getMotionTracking()` Parâmetros: nenhum Valor de retorno: `boolean` Retorna o estado do rastreador de movimento. Se `true` quando o usuário mover fisicamente o dispositivo e o navegador permitir, o panorama do Street View rastreará os movimentos físicos.
`getPano`	`getPano()` Parâmetros: nenhum Valor de retorno: `string` Retorna o ID do panorama atual para o panorama do Street View. Esse ID é estável apenas dentro da sessão atual do navegador.
`getPhotographerPov`	`getPhotographerPov()` Parâmetros: nenhum Valor de retorno: `StreetViewPov` Retorna a direção e a inclinação do fotógrafo quando o panorama foi feito. Para panoramas do Street View na estrada, isso também revela em que direção o carro estava indo. Esses dados estão disponíveis após o evento `pano_changed`.
`getPosition`	`getPosition()` Parâmetros: nenhum Valor de retorno: `LatLng\|null` Retorna a posição `LatLng` atual do panorama do Street View.
`getPov`	`getPov()` Parâmetros: nenhum Valor de retorno: `StreetViewPov` Retorna o ponto de vista atual para o panorama do Street View.
`getStatus`	`getStatus()` Parâmetros: nenhum Valor de retorno: `StreetViewStatus` Retorna o status do panorama após a conclusão da solicitação `setPosition()` ou `setPano()`.
`getVisible`	`getVisible()` Parâmetros: nenhum Valor de retorno: `boolean` Retorna `true` se o panorama é visível. Não especifica se as imagens do Street View estão disponíveis na posição especificada.
`getZoom`	`getZoom()` Parâmetros: nenhum Valor de retorno: `number` Retorna o nível de zoom do panorama. O nível total de zoom reduzido é o nível 0, em que o campo de visão é de 180 graus. Aumentar o zoom aumenta o nível de zoom.
`registerPanoProvider`	`registerPanoProvider(provider[, opt_options])` Parâmetros: `provider`: `function(string): (StreetViewPanoramaData optional)` `opt_options`: `PanoProviderOptions optional` Valor de retorno: nenhum Define o provedor de panorama personalizado chamado na alteração do panorama para carregar panoramas personalizados.
`setLinks`	`setLinks(links)` Parâmetros: `links`: `Array<StreetViewLink>` Valor de retorno: nenhum Define o conjunto de links de navegação para o panorama do Street View.
`setMotionTracking`	`setMotionTracking(motionTracking)` Parâmetros: `motionTracking`: `boolean` Valor de retorno: nenhum Define o estado do rastreador de movimento. Se `true` quando o usuário mover fisicamente o dispositivo e o navegador permitir, o panorama do Street View rastreará os movimentos físicos.
`setOptions`	`setOptions(options)` Parâmetros: `options`: `StreetViewPanoramaOptions optional` Valor de retorno: nenhum Define uma coleção de pares de chave e valor.
`setPano`	`setPano(pano)` Parâmetros: `pano`: `string` Valor de retorno: nenhum Define o ID do panorama atual para o panorama do Street View.
`setPosition`	`setPosition(latLng)` Parâmetros: `latLng`: `LatLng\|LatLngLiteral optional` Valor de retorno: nenhum Define a posição `LatLng` atual para o panorama do Street View.
`setPov`	`setPov(pov)` Parâmetros: `pov`: `StreetViewPov` Valor de retorno: nenhum Define o ponto de vista para o panorama do Street View.
`setVisible`	`setVisible(flag)` Parâmetros: `flag`: `boolean` Valor de retorno: nenhum Define como `true` para tornar o panorama visível. Se definido como `false`, o panorama ficará oculto, independentemente de estar incorporado ao mapa ou ao próprio `<div>`.
`setZoom`	`setZoom(zoom)` Parâmetros: `zoom`: `number` Valor de retorno: nenhum Define o nível de zoom do panorama. O nível total de zoom reduzido é o nível 0, em que o campo de visão é de 180 graus. Aumentar o zoom aumenta o nível de zoom.
Herdado: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Eventos
`closeclick`	`function(event)` Argumentos: `event`: `Event` o evento acionado. Este evento é disparado quando o botão Fechar é clicado.
`pano_changed`	`function()` Argumentos: nenhum Este evento é disparado quando o ID do panorama é alterado. O panorama pode ser alterado enquanto o usuário navega por ele ou se a posição for definida manualmente. Nem todas as mudanças de posição acionam uma `pano_changed`.
`position_changed`	`function()` Argumentos: nenhum Este evento é disparado quando a posição do panorama é alterada. A posição muda enquanto o usuário navega pelo panorama ou a posição é definida manualmente.
`pov_changed`	`function()` Argumentos: nenhum Este evento é disparado quando o ponto de vista do panorama é alterado. O ponto de vista é alterado quando a inclinação, o zoom ou a direção são alterados.
`resize`	`function()` Argumentos: nenhum Os desenvolvedores precisam acionar esse evento no panorama quando o div mudar de tamanho: `google.maps.event.trigger(panorama, 'resize')`.
`status_changed`	`function()` Argumentos: nenhum Este evento é disparado depois de cada pesquisa de panorama por ID ou local via `setPosition()` ou `setPano()`.
`visible_changed`	`function()` Argumentos: nenhum Este evento é disparado quando a visibilidade do panorama é alterada. A visibilidade é alterada quando o Pegman é arrastado para o mapa, o botão "Fechar" é clicado ou `setVisible()` é chamado.
`zoom_changed`	`function()` Argumentos: nenhum Este evento é disparado quando o nível de zoom do panorama é alterado.

StreetViewPanoramaOptions interface

google.maps.StreetViewPanoramaOptions interface

Opções que definem as propriedades de um objeto StreetViewPanorama.

Propriedades
`addressControl optional`	Tipo: `boolean optional` O estado ativado/desativado do controle de endereço.
`addressControlOptions optional`	Tipo: `StreetViewAddressControlOptions optional` As opções de exibição do controle de endereço.
`clickToGo optional`	Tipo: `boolean optional` Padrão:`true` O estado ativado/desativado do recurso click-to-go. Não aplicável a panoramas personalizados.
`controlSize optional`	Tipo: `number optional` Tamanho dos controles que aparecem no panorama em pixels. Esse valor precisa ser fornecido diretamente durante a criação do panorama. Se você atualizá-lo posteriormente, os controles podem ficar em um estado indefinido. Rege apenas os controles realizados pela própria API do Google Maps. Não escalona controles personalizados criados pelo desenvolvedor.
`disableDefaultUI optional`	Tipo: `boolean optional` Ativa/desativa todas as interfaces de usuário padrão. Pode ser substituída individualmente.
`disableDoubleClickZoom optional`	Tipo: `boolean optional` Padrão:`true` Ativa/desativa o zoom com dois cliques.
`enableCloseButton optional`	Tipo: `boolean optional` Padrão:`false` Se for `true`, o botão "Fechar" será exibido.
`fullscreenControl optional`	Tipo: `boolean optional` O estado ativado/desativado do controle de tela cheia.
`fullscreenControlOptions optional`	Tipo: `FullscreenControlOptions optional` As opções de exibição do controle de tela cheia.
`imageDateControl optional`	Tipo: `boolean optional` O estado ativado/desativado do controle de data de aquisição de imagens. Essa configuração está desativada por padrão.
`linksControl optional`	Tipo: `boolean optional` O estado ativado/desativado do controle de links.
`motionTracking optional`	Tipo: `boolean optional` Se o rastreamento de movimento está ativado ou desativado. Ativado por padrão quando o controle de rastreamento de movimento está presente e a permissão é concedida por um usuário ou não é necessária, para que o POV (ponto de vista) siga a orientação do dispositivo. Isso se aplica principalmente a dispositivos móveis. Se `motionTracking` for definido como `false` enquanto `motionTrackingControl` estiver ativado, o controle de rastreamento de movimento vai aparecer, mas o rastreamento ficará desativado. O usuário pode tocar no controle de rastreamento de movimento para alternar essa opção. Se a `motionTracking` for definida como `true` e a permissão for necessária, mas ainda não tiver sido solicitada, o controle de rastreamento de movimento vai aparecer, mas o rastreamento será desativado. O usuário pode tocar no controle de rastreamento de movimento para solicitar permissão. Se `motionTracking` for definido como `true` enquanto a permissão for negada por um usuário, o controle de rastreamento de movimento aparecerá desativado.
`motionTrackingControl optional`	Tipo: `boolean optional` O estado ativado/desativado do controle de rastreamento de movimento. Ativada por padrão quando o dispositivo tem dados de movimento para que o controle apareça no mapa. Isso se aplica principalmente a dispositivos móveis.
`motionTrackingControlOptions optional`	Tipo: `MotionTrackingControlOptions optional` As opções de exibição do controle de rastreamento de movimento.
`panControl optional`	Tipo: `boolean optional` O estado ativado/desativado do controle de panorâmica.
`panControlOptions optional`	Tipo: `PanControlOptions optional` As opções de exibição do controle de panorâmica.
`pano optional`	Tipo: `string optional` O ID do panorama, que deve ser definido na especificação de um panorama personalizado.
`position optional`	Tipo: `LatLng\|LatLngLiteral optional` A posição `LatLng` do panorama do Street View.
`pov optional`	Tipo: `StreetViewPov optional` A orientação da câmera, especificada como direção e inclinação, para o panorama.
`scrollwheel optional`	Tipo: `boolean optional` Padrão:`true` Se `false`, desativa o zoom da roda de rolagem no Street View.
`showRoadLabels optional`	Tipo: `boolean optional` Padrão:`true` A exibição de nomes de ruas no panorama. Se esse valor não for especificado ou for definido como `true`, os nomes das ruas serão exibidos no panorama. Se definido como `false`, os nomes das ruas não serão exibidos.
`visible optional`	Tipo: `boolean optional` Se for `true`, o panorama do Street View será visível no carregamento.
`zoom optional`	Tipo: `number optional` O zoom do panorama, especificado como um número. Um zoom de 0 proporciona um campo de visão de 180 graus.
`zoomControl optional`	Tipo: `boolean optional` O estado ativado/desativado do controle de zoom.
`zoomControlOptions optional`	Tipo: `ZoomControlOptions optional` As opções de exibição do controle de zoom.

StreetViewAddressControlOptions interface

google.maps.StreetViewAddressControlOptions interface

Opções para a renderização do controle de endereço do Street View.

Propriedades
`position optional`	Tipo: `ControlPosition optional` ID da posição. Esse ID é usado para especificar a posição do controle no mapa. A posição padrão é `TOP_LEFT`.

PanoProviderOptions interface

google.maps.PanoProviderOptions interface

Opções para o provedor de panoramas personalizados.

Propriedades
`cors optional`	Tipo: `boolean optional` Se definido, o renderizador usará tecnologias (como webgl) que só funcionam quando os cabeçalhos dos cors estão definidos adequadamente nas imagens fornecidas. É tarefa do desenvolvedor exibir as imagens corretamente em combinação com essa sinalização, o que poderia levar a SecurityErrors.

StreetViewTileData interface

google.maps.StreetViewTileData interface

As propriedades do conjunto de blocos usado em um panorama do Street View.

Propriedades
`centerHeading`	Tipo: `number` A orientação (em graus) no centro dos blocos panorâmicos.
`tileSize`	Tipo: `Size` O tamanho (em pixels) no qual os blocos serão renderizados.
`worldSize`	Tipo: `Size` O tamanho (em pixels) do "mundo" no panorama completo.

Métodos
`getTileUrl`	`getTileUrl(pano, tileZoom, tileX, tileY)` Parâmetros: `pano`: `string` `tileZoom`: `number` `tileX`: `number` `tileY`: `number` Valor de retorno: `string` Obtém o URL da imagem de bloco do bloco especificado. Esse é um método personalizado que você precisa implementar para fornecer blocos personalizados. A API chama esse método com os seguintes parâmetros: `pano` é o ID do panorama do bloco do Street View. `tileZoom` é o nível de zoom do bloco. `tileX` é a coordenada x do bloco. `tileY` é a coordenada y do bloco. Seu método personalizado precisa retornar o URL da imagem do bloco.

Métodos

getTileUrl

getTileUrl(pano, tileZoom, tileX, tileY)

Parâmetros:

pano: string
tileZoom: number
tileX: number
tileY: number

Valor de retorno: string

Obtém o URL da imagem de bloco do bloco especificado.
Esse é um método personalizado que você precisa implementar para fornecer blocos personalizados. A API chama esse método com os seguintes parâmetros:
pano é o ID do panorama do bloco do Street View.
tileZoom é o nível de zoom do bloco.
tileX é a coordenada x do bloco.
tileY é a coordenada y do bloco.
Seu método personalizado precisa retornar o URL da imagem do bloco.

StreetViewPov interface

google.maps.StreetViewPov interface

Um objeto de ponto de vista que especifica a orientação da câmera na posição do panorama do Street View. O ponto de vista é definido como direção e inclinação.

Propriedades
`heading`	Tipo: `number` A direção da câmera em graus em relação à `true` ao norte. O norte absoluto é 0°, o leste é 90°, o sul é 180° e o oeste é 270°.
`pitch`	Tipo: `number` A inclinação da câmera em graus com base no veículo do Street View. Varia de 90° (diretamente para cima) a -90° (diretamente para baixo).

StreetViewCoverageLayer aula

Classe google.maps.StreetViewCoverageLayer

Uma camada que ilustra os locais onde o Street View está disponível.

Essa classe estende MVCObject:

Acesse chamando const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView"). Consulte Bibliotecas na API Maps JavaScript.

Construtor
`StreetViewCoverageLayer`	`StreetViewCoverageLayer()` Parâmetros: nenhum Cria uma nova instância do `StreetViewCoverageLayer`.

Métodos
`getMap`	`getMap()` Parâmetros: nenhum Valor de retorno: `Map\|null` Retorna o mapa no qual esta camada é exibida.
`setMap`	`setMap(map)` Parâmetros: `map`: `Map optional` Valor de retorno: `undefined` Renderiza a camada no mapa especificado. Se o mapa estiver definido como "null", a camada será removida.
Herdado: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Rendering

StreetViewPanorama aula

Construtor

Propriedades

Métodos

Eventos

StreetViewPanoramaOptions interface

Propriedades

StreetViewAddressControlOptions interface

Propriedades

PanoProviderOptions interface

Propriedades

StreetViewTileData interface

Propriedades

Métodos

StreetViewPov interface

Propriedades

StreetViewCoverageLayer aula

Construtor

Métodos