Anúncio:em breve, a Plataforma Google Maps vai ter um novo estilo de mapa de base. Essa atualização inclui uma nova paleta de cores padrão, pinos modernizados 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

Classe StreetViewPanorama

Classe google.maps.StreetViewPanorama

Mostra o panorama para um determinado LatLng ou ID de panorama. Um objeto StreetViewPanorama fornece um "visualizador" do Street View que pode ser independente em 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 neste `StreetViewPanorama`. Considere usar esse método com um evento `visible_changed` para garantir que `StreetViewPanorama` esteja visível antes de definir o foco nele. Um `StreetViewPanorama` que não está visível não pode ser focado.
`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 move fisicamente o dispositivo e o navegador oferece suporte a ele, o panorama do Street View rastreia 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 o ângulo de elevação e de inclinação do fotógrafo quando o panorama foi tirado. Para panoramas do Street View na estrada, isso também revela em que direção o carro estava viajando. 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 atual da `LatLng` para o 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 estiver 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 0 é o zoom totalmente desativado, em que o campo de visão é de 180 graus. 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 move fisicamente o dispositivo e o navegador oferece suporte a ele, o panorama do Street View rastreia 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 atual do `LatLng` 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 definida como `false`, o panorama será oculto, mesmo que esteja incorporado no mapa ou no 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 0 é o zoom totalmente desativado, em que o campo de visão é de 180 graus. 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 foi 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 tamanho do div mudar: `google.maps.event.trigger(panorama, 'resize')`.
`status_changed`	`function()` Argumentos: nenhum Esse evento é acionado após cada pesquisa de panorama por ID ou local, usando `setPosition()` ou `setPano()`.
`visible_changed`	`function()` Argumentos: nenhum Este evento é disparado quando a visibilidade do panorama é alterada. A visibilidade muda quando o Pegman é arrastado para o mapa, quando o botão de fechar é clicado ou quando `setVisible()` é chamado.
`zoom_changed`	`function()` Argumentos: nenhum Esse evento é acionado quando o nível de zoom do panorama muda.

Interface StreetViewPanoramaOptions

Interface google.maps.StreetViewPanoramaOptions

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 "Clique para ir". Não é aplicável a panoramas personalizados.
`controlSize optional`	Tipo:`number optional` Tamanho em pixels dos controles que aparecem no panorama. Esse valor precisa ser fornecido diretamente ao criar o Panorama. Atualizar esse valor mais tarde pode levar os controles a um estado indefinido. Governa apenas os controles feitos pela própria API Maps. Não dimensiona 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 `true`, o botão de fechar será mostrado.
`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 para o controle de tela cheia.
`imageDateControl optional`	Tipo:`boolean optional` O estado ativado/desativado do controle da data de aquisição das 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` Indica 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 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 vai estar desativado. O usuário pode tocar no controle de rastreamento de movimento para ativar essa opção. Se `motionTracking` estiver definido como `true`, mas a permissão for necessária e ainda não tiver sido solicitada, o controle de rastreamento de movimento vai aparecer, mas o rastreamento estará desativado. O usuário pode tocar no controle de rastreamento de movimento para solicitar a permissão. Se `motionTracking` for definido como `true` enquanto a permissão for negada por um usuário, o controle de rastreamento de movimento vai aparecer desativado com o rastreamento 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 vão aparecer no panorama. Se definido como `false`, os nomes das ruas não são mostrados.
`visible optional`	Tipo:`boolean optional` Se `true`, o panorama do Street View fica visível no carregamento.
`zoom optional`	Tipo:`number optional` O zoom do panorama, especificado como um número. Um zoom de 0 dá 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.

Interface StreetViewAddressControlOptions

Interface google.maps.StreetViewAddressControlOptions

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

Interface PanoProviderOptions

Interface google.maps.PanoProviderOptions

Opções para o provedor de Pano personalizado.

Propriedades
`cors optional`	Tipo:`boolean optional` Se definido, o renderizador vai usar tecnologias (como o WebGL) que só funcionam quando os cabeçalhos de cores estão definidos corretamente nas imagens fornecidas. É responsabilidade do desenvolvedor veicular as imagens corretamente em combinação com essa flag, o que pode levar a erros de segurança.

Interface StreetViewTileData

Interface google.maps.StreetViewTileData

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, fornecendo 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, fornecendo 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.

Interface StreetViewPov

Interface google.maps.StreetViewPov

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 ao norte `true`. 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).

Classe StreetViewCoverageLayer

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:nenhum Renderiza a camada no mapa especificado. Se o mapa for definido como nulo, a camada será removida.
Herdado: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Rendering

Classe StreetViewPanorama

Construtor

Propriedades

Métodos

Eventos

Interface StreetViewPanoramaOptions

Propriedades

Interface StreetViewAddressControlOptions

Propriedades

Interface PanoProviderOptions

Propriedades

Interface StreetViewTileData

Propriedades

Métodos

Interface StreetViewPov

Propriedades

Classe StreetViewCoverageLayer

Construtor

Métodos