Street View

Selecione a plataforma: Android iOS JavaScript

Com o Street View do Google Maps, você conhece lugares no mundo todo usando imagens da rua em 360 graus. Você pode explorar pontos turísticos, ver maravilhas naturais, navegar em uma viagem ou mostrar o lado externo da sua empresa.

Visão geral

O Google Street View oferece vistas panorâmicas de 360° de vias designadas em toda a área de cobertura. A cobertura disponível pelo SDK é a mesma do app Google Maps para iOS ou do https://maps.google.com/. Leia mais sobre o Street View e confira as áreas compatíveis em um mapa interativo. Acesse Sobre o Street View.

O SDK do Maps para iOS oferece um serviço do Street View para acessar e manipular imagens usadas no Street View do Google Maps. As imagens do Street View são retornadas como panoramas e vistas no visualizador do Street View, um objeto do tipo GMSPanoramaView.

Panoramas do Street View

Cada panorama do Street View é uma imagem ou um conjunto de imagens que oferece uma visualização completa em 360 graus de um único local. As imagens estão em conformidade com a projeção equirretangular (Plate Carrée), que contém 360 graus de visualização horizontal (uma volta completa em torno de um ponto) e 180 graus de visualização vertical (do ponto mais alto ao mais baixo). O panorama de 360 graus resultante define uma projeção em uma esfera com a imagem cobrindo a superfície bidimensional dessa esfera.

Os panoramas do Street View são visíveis com o objeto GMSPanoramaView. Esse objeto fornece um visualizador que renderiza o panorama como uma esfera, com uma câmera no centro. É possível controlar de maneira programática a orientação da câmera, bem como várias propriedades que personalizam o visualizador.

Como acessar dados do Street View

Os panoramas do Street View são identificados por um destes fragmentos de metadados:

panoramaID
O ID exclusivo de um panorama do Street View. Esse panoramaID pode mudar com o tempo e não é adequado como uma referência de longo prazo ou codificada. O panoramaID é mais usado para oferecer acesso programático a diferentes imagens do Street View.
coordinate
O local exato da imagem, expresso como um CLLocationCoordinate2D. Use um coordinate para armazenar persistentemente o local de um panorama ou para converter as ações do usuário no mapa em uma imagem do Street View.

Tanto panoramaID quanto coordinate são armazenados como propriedades do objeto GMSPanorama. Você pode solicitar um GMSPanorama do GMSPanoramaService usando coordinate ou panoramaID. O objeto resultante incluirá ambos os metadados, bem como uma matriz de links para panoramas próximos.

Como definir o local do panorama

O local do panorama do Street View pode ser definido com base na coordenada.

  • O método moveNearCoordinate solicita um panorama perto da coordenada.

  • O método moveNearCoordinate:radius é semelhante, mas permite especificar um raio de pesquisa, em metros, ao redor da coordenada.

  • O método moveNearCoordinate:source permite especificar uma origem. Use uma fonte se você quiser restringir o Street View para procurar apenas panoramas que estão na área externa. Por padrão, os panoramas dos locais podem ser internos ou externos. e pode ser que não existam panoramas externos para o local especificado.

  • O método moveNearCoordinate:radius:source permite especificar um raio e uma origem.

Como visualizar imagens do Street View

Adicionar um visualizador do Street View

As etapas básicas para adicionar um visualizador são:

  1. (Uma vez) Siga as etapas em Como começar para fazer o download do SDK, conseguir uma chave e adicionar os frameworks necessários.
  2. Crie ou atualize um ViewController. Se o panorama for exibido quando esse controlador de visualização ficar visível, crie-o no método loadView.
  3. Crie e instancie uma classe GMSPanoramaView usando o método GMSPanoramaView initWithFrame:. Se ele for usado como a única visão do controlador de visualização, CGRectZero poderá ser usado como frame do mapa. O mapa será redimensionado automaticamente.
  4. Defina o objeto GMSPanoramaView como a visualização do controlador de visualizações, por exemplo, self.view = panoView;.
  5. Defina o local da imagem do Street View usando um método como moveNearCoordinate:.

O método a seguir adiciona um visualizador do Street View a um aplicativo.

Swift

import GoogleMaps

class StreetView: UIViewController {

  override func loadView() {
    let panoView = GMSPanoramaView(frame: .zero)
    self.view = panoView

    panoView.moveNearCoordinate(CLLocationCoordinate2D(latitude: -33.732, longitude: 150.312))
  }
}

Objective-C

#import "StreetView.h"
@import GoogleMaps;

@interface StreetView ()

@end

@implementation StreetView

- (void)loadView {
  GMSPanoramaView *panoView = [[GMSPanoramaView alloc] initWithFrame:CGRectZero];
  self.view = panoView;

  [panoView moveNearCoordinate:CLLocationCoordinate2DMake(-33.732, 150.312)];
}

@end

Personalizar o visualizador

Personalize o visualizador restringindo os gestos disponíveis. Por padrão, a movimentação, o zoom e o acesso a panoramas adjacentes estão ativados. Gestos individuais são controlados pelas propriedades do GMSPanoramaView. Essas propriedades ativam ou desativam gestos controlados pelo usuário. Mudanças programáticas ainda são possíveis quando o gesto está desativado.

orientationGestures
Define se o usuário poderá reorientar a câmera tocando ou arrastando. Defina como NO para desativar as mudanças de orientação da câmera.
zoomGestures
Define se o usuário pode fazer gesto de pinça para aplicar zoom. Defina como NO para desativar o zoom.
navigationGestures
Define se o usuário poderá mudar qual panorama é visível. Os usuários podem usar um único toque nos links de navegação ou dois toques na visualização para alterar os panoramas. Defina como NO para desativar as mudanças de navegação.

Você pode ativar ou desativar todos os gestos de uma só vez com o método setAllGesturesEnabled:.

Swift

panoView.setAllGesturesEnabled(false)

Objective-C

[panoView setAllGesturesEnabled:NO];

Iniciar o Street View com o esquema de URL

As imagens do Google Street View são visíveis no aplicativo do Google Maps para iOS. Você pode iniciar o app Google Maps para iOS no modo Street View com o esquema de URL comgooglemaps definindo o parâmetro mapmode como streetview. Confira abaixo um exemplo de URL que inicia o Street View. Para mais informações, consulte a documentação Esquema de URL.

comgooglemaps://?center=46.414382,10.013988&mapmode=streetview

Locais e ponto de vista (POV) do Street View

O GMSPanoramaCamera permite definir o ponto de vista da câmera do Street View como uma combinação de direção, inclinação e zoom.

O fragmento a seguir orienta a câmera para o sul e ligeiramente para baixo.

Swift

panoView.camera = GMSPanoramaCamera(heading: 180, pitch: -10, zoom: 1)

Objective-C

panoView.camera = [GMSPanoramaCamera cameraWithHeading:180
                                                 pitch:-10
                                                  zoom:1];

Orientações

O local do Street View define o posicionamento do foco da câmera para uma imagem, mas não a orientação da câmera para essa imagem. Para isso, o objeto GMSOrientation define duas propriedades:

  • heading define o ângulo de rotação em graus ao redor do local da câmera em relação ao norte verdadeiro. A orientação é medida no sentido horário: o norte verdadeiro é 0, o leste é 90, o sul é 180 e o oeste é 270.
  • pitch (padrão 0) define a variação "para cima" ou "para baixo" do ângulo em relação à inclinação inicial padrão da câmera. Frequentemente, mas nem sempre, ela é plana e horizontal. Por exemplo, uma imagem capturada em uma colina provavelmente terá um valor padrão de inclinação não horizontal. Os ângulos de inclinação são medidos com valores positivos apontando para cima (até +90 graus para cima e ortogonalmente em relação à inclinação padrão) e valores negativos olhando para baixo (até -90 graus para baixo e ortogonalmente em relação à inclinação padrão).

Zoom

O Street View permite níveis diferentes de detalhes de imagem por meio do zoom. É possível definir o nível de zoom de maneira programática ou alterar o nível no visualizador fazendo gesto de pinça.

Como mover a câmera

Depois de criar a GMSPanoramaView e ela tiver uma câmera configurada ou padrão, é possível alterá-la de várias maneiras. Quando você muda a câmera, tem a opção de animar o movimento resultante dela. A animação alterna entre os atributos atuais da câmera e os novos atributos.

É possível modificar o objeto GMSPanoramaCamera e defini-lo na propriedade camera do GMSPanoramaView. Isso vai encaixar a câmera no novo ponto de vista sem animação. Uma GMSCameraPosition pode ser criada para configurar qualquer combinação de orientação e zoom.

Swift

panoView.camera = GMSPanoramaCamera(heading: 180, pitch: -10, zoom: 1)

Objective-C

panoView.camera = [GMSPanoramaCamera cameraWithHeading:180
                                                 pitch:-10
                                                  zoom:1];

Você pode animar uma transição chamando o método animateToCamera:animationDuration: de GMSPanoramaView. Além disso, é possível controlar a câmera usando Core Animation. Isso é disponibilizado pelo CALayer personalizado em GMSPanoramaView, GMSPanoramaLayer.

Marcadores no Street View

O objeto GMSPanoramaView pode mostrar marcadores do mapa. Para usar o mesmo objeto GMSMarker em um objeto GMSMapView ou GMSPanoramaView, defina as propriedades correspondentes:

Swift

// Create a marker at the Eiffel Tower
let position = CLLocationCoordinate2D(latitude: 48.858, longitude: 2.294)
let marker = GMSMarker(position: position)

// Add the marker to a GMSPanoramaView object named panoView
marker.panoramaView = panoView

// Add the marker to a GMSMapView object named mapView
marker.map = mapView

Objective-C

// Create a marker at the Eiffel Tower
CLLocationCoordinate2D position = CLLocationCoordinate2DMake(48.858,2.294);
GMSMarker *marker = [GMSMarker markerWithPosition:position];

// Add the marker to a GMSPanoramaView object named panoView
marker.panoramaView = panoView;

// Add the marker to a GMSMapView object named mapView
marker.map = mapView;

O tamanho dos marcadores é redimensionado em função da distância entre a posição deles e a localização de GMSCameraView. Se essa distância ficar muito grande, o marcador ficará muito pequeno para ser exibido e ficará oculto.

Defina a propriedade panoramaView como nil para removê-la do GMSPanoramaView.

Swift

marker.panoramaView = nil

Objective-C

marker.panoramaView = nil;

Eventos

Você pode detectar eventos que ocorrem no panorama do Street View, como o toque de um usuário. Para detectar eventos, implemente o protocolo GMSPanoramaViewDelegate. Consulte o guia geral para eventos e a lista de métodos na GMSPanoramaViewDelegate.