Maps

Classe MapElement

classe google.maps.MapElement estende HTMLElement implementa MapElementOptions
biblioteca "maps"

MapElement é uma subclasse HTMLElement para renderizar mapas. Depois de carregar a biblioteca maps, um mapa pode ser criado em HTML. Exemplo:

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

<gmp-map
  center="lat,lng"
  heading-interaction-disabled
  internal-usage-attribution-ids="id1 id2"
  map-id="string"
  rendering-type="value-name"
  tilt-interaction-disabled
  zoom="number">
</gmp-map>

const {MapElement} = await google.maps.importLibrary("maps");

Interface MapElementOptions

interface google.maps.MapElementOptions
implementada por MapElement

Objeto MapElementOptions usado para definir as propriedades que podem ser definidas em um MapElement.

Classe ZoomChangeEvent

classe google.maps.ZoomChangeEvent estende Event
biblioteca "maps"

Esse evento é criado ao monitorar a mudança de zoom.

const {ZoomChangeEvent} = await google.maps.importLibrary("maps");

Classe Map

classe google.maps.Map estende MVCObject
biblioteca "maps"

const {Map} = await google.maps.importLibrary("maps");

Métodos
fitBounds	fitBounds(bounds[, padding]) Parâmetros: bounds: LatLngBounds|LatLngBoundsLiteral limites para mostrar. padding: number|Padding optional Padding em pixels. Os limites serão ajustados na parte do mapa que permanece após a remoção do padding. Um valor numérico vai gerar o mesmo padding nos quatro lados. Informe 0 aqui para tornar um fitBounds idempotente no resultado de getBounds. Valor de retorno: nenhum Define a janela de visualização para que contenha os limites fornecidos. Observação: quando o mapa é definido como display: none, a função fitBounds lê o tamanho do mapa como 0x0 e, portanto, não faz nada. Para mudar a janela de visualização enquanto o mapa está oculto, defina-o como visibility: hidden, garantindo que a div do mapa tenha um tamanho real. Para mapas vetoriais, esse método define a inclinação e a direção do mapa como os valores padrão de zero. Chamar esse método pode causar uma animação suave à medida que o mapa se move e aumenta o zoom para se ajustar aos limites. Se esse método é animado ou não depende de uma heurística interna.
getBounds	getBounds() Parâmetros: nenhum Valor de retorno: LatLngBounds|undefined os limites de latitude/longitude da janela de visualização atual. Retorna os limites de latitude/longitude da janela de visualização atual. Se mais de uma cópia do mundo estiver visível, os limites de longitude vão variar de -180 a 180 graus. Se o mapa ainda não tiver sido inicializado ou se o centro e o zoom não tiverem sido definidos, o resultado será undefined. Para mapas vetoriais com inclinação ou direção diferente de zero, os limites de latitude/longitude retornados representam a menor caixa delimitadora que inclui a região visível da janela de visualização do mapa. Consulte MapCanvasProjection.getVisibleRegion para saber como ver a região visível exata da janela de visualização do mapa.
getCenter	getCenter() Parâmetros: nenhum Valor de retorno: LatLng|undefined Retorna a posição mostrada no centro do mapa. Esse objeto LatLng não é encapsulado. Consulte LatLng para saber mais. Se o centro ou os limites não tiverem sido definidos, o resultado será undefined.
getClickableIcons	getClickableIcons() Parâmetros: nenhum Valor de retorno: boolean|undefined Retorna a clicabilidade dos ícones do mapa. Um ícone de mapa representa um ponto de interesse, também conhecido como PDI. Se o valor retornado for true, os ícones serão clicáveis no mapa.
getDatasetFeatureLayer	getDatasetFeatureLayer(datasetId) Parâmetros: datasetId: string Valor de retorno: FeatureLayer Retorna o FeatureLayer para o datasetId especificado. Os IDs de conjunto de dados precisam ser configurados no console do Google Cloud. Se o ID do conjunto de dados não estiver associado ao estilo de mapa do mapa ou se o estilo baseado em dados não estiver disponível (sem ID do mapa, sem blocos vetoriais, sem camadas de elementos de estilo baseado em dados ou conjuntos de dados configurados no estilo de mapa), isso vai registrar um erro, e o FeatureLayer.isAvailable resultante será falso.
getDiv	getDiv() Parâmetros: nenhum Valor de retorno: HTMLElement o mapDiv do mapa.
getFeatureLayer	getFeatureLayer(featureType) Parâmetros: featureType: FeatureType Valor de retorno: FeatureLayer Retorna o FeatureLayer do FeatureType específico. Uma FeatureLayer precisa ser ativada no console do Google Cloud. Se um FeatureLayer do FeatureType especificado não existir nesse mapa ou se o estilo baseado em dados não estiver disponível (sem ID do mapa, sem blocos vetoriais e sem FeatureLayer ativado no estilo de mapa), um erro será registrado, e o FeatureLayer.isAvailable resultante será falso.
getHeading	getHeading() Parâmetros: nenhum Valor de retorno: number|undefined Retorna a direção da bússola do mapa. O valor da orientação é medido em graus (sentido horário) a partir da direção cardeal norte. Se o mapa ainda não tiver sido inicializado, o resultado será undefined.
getHeadingInteractionEnabled	getHeadingInteractionEnabled() Parâmetros: nenhum Valor de retorno: boolean|null Retorna se as interações de título estão ativadas. Essa opção só é válida quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem do ID do mapa será usada (se disponível).
getInternalUsageAttributionIds	getInternalUsageAttributionIds() Parâmetros: nenhum Valor de retorno: Iterable<string>|null Retorna a lista de IDs de atribuição de uso, que ajudam o Google a entender quais bibliotecas e exemplos são úteis para os desenvolvedores, como o uso de uma biblioteca de clustering de marcadores.
getMapCapabilities	getMapCapabilities() Parâmetros: nenhum Valor de retorno: MapCapabilities Informa ao autor da chamada os recursos disponíveis para o mapa com base no ID fornecido.
getMapTypeId	getMapTypeId() Parâmetros: nenhum Valor de retorno: MapTypeId|string|undefined
getProjection	getProjection() Parâmetros: nenhum Valor de retorno: Projection|undefined Retorna o Projection atual. Se o mapa ainda não tiver sido inicializado, o resultado será undefined. Detecte o evento projection_changed e verifique o valor dele para garantir que não seja undefined.
getRenderingType	getRenderingType() Parâmetros: nenhum Valor de retorno: RenderingType Retorna o RenderingType atual do mapa.
getStreetView	getStreetView() Parâmetros: nenhum Valor de retorno: StreetViewPanorama o panorama vinculado ao mapa. Retorna o StreetViewPanorama padrão vinculado ao mapa, que pode ser um panorama padrão incorporado ao mapa ou o panorama definido usando setStreetView(). As mudanças no streetViewControl do mapa serão refletidas na exibição desse panorama vinculado.
getTilt	getTilt() Parâmetros: nenhum Valor de retorno: number|undefined Retorna o ângulo de incidência atual do mapa, em graus, do plano da janela de visualização para o plano do mapa. Para mapas rasterizados, o resultado será 0 para imagens tiradas diretamente de cima ou 45 para imagens em 45°. Esse método não retorna o valor definido por setTilt. Consulte setTilt para ver detalhes.
getTiltInteractionEnabled	getTiltInteractionEnabled() Parâmetros: nenhum Valor de retorno: boolean|null Informa se as interações de inclinação estão ativadas. Essa opção só é válida quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem do ID do mapa será usada (se disponível).
getZoom	getZoom() Parâmetros: nenhum Valor de retorno: number|undefined Retorna o zoom do mapa. Se o zoom não tiver sido definido, o resultado será undefined.
moveCamera	moveCamera(cameraOptions) Parâmetros: cameraOptions: CameraOptions Valor de retorno: nenhum Define imediatamente a câmera do mapa para as opções de câmera de destino, sem animação.
panBy	panBy(x, y) Parâmetros: x: number Número de pixels para mover o mapa na direção x. y: number Número de pixels para mover o mapa na direção y. Valor de retorno: nenhum Altera o centro do mapa de acordo com a distância especificada em pixels. Se a distância for menor do que a largura e a altura do mapa, a transição será animada suavemente. O sistema de coordenadas do mapa aumenta do oeste para o leste (para valores x) e do norte para o sul (para valores y).
panTo	panTo(latLng) Parâmetros: latLng: LatLng|LatLngLiteral: a nova latitude/longitude central do mapa. Valor de retorno: nenhum Muda o centro do mapa para o LatLng fornecido. Se a alteração for menor do que a largura e a altura do mapa, a transição será animada suavemente.
panToBounds	panToBounds(latLngBounds[, padding]) Parâmetros: latLngBounds: LatLngBounds|LatLngBoundsLiteral Os limites para deslocar o mapa. padding: number|Padding optional Padding em pixels. Um valor numérico vai gerar o mesmo padding nos quatro lados. O valor padrão é 0. Valor de retorno: nenhum Move o mapa pela quantidade mínima necessária para conter o LatLngBounds fornecido. Não há garantia de onde os limites estarão no mapa, exceto que o mapa será deslocado para mostrar o máximo possível dos limites dentro de {currentMapSizeInPx} - {padding}. Para mapas rasterizados e vetoriais, o zoom, a inclinação e a direção do mapa não serão alterados.
setCenter	setCenter(latlng) Parâmetros: latlng: LatLng|LatLngLiteral Valor de retorno: nenhum
setClickableIcons	setClickableIcons(value) Parâmetros: value: boolean Valor de retorno: nenhum Controla se os ícones do mapa são clicáveis ou não. Um ícone de mapa representa um ponto de interesse, também conhecido como PDI. Para desativar a capacidade de clicar nos ícones do mapa, transmita um valor de false para esse método.
setHeading	setHeading(heading) Parâmetros: heading: number Valor de retorno: nenhum Define a direção da bússola para o mapa, medida em graus a partir do ponto cardeal Norte. Para mapas rasterizados, esse método se aplica apenas a imagens aéreas.
setHeadingInteractionEnabled	setHeadingInteractionEnabled(headingInteractionEnabled) Parâmetros: headingInteractionEnabled: boolean Valor de retorno: nenhum Define se as interações de título estão ativadas. Essa opção só é válida quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem do ID do mapa será usada (se disponível).
setMapTypeId	setMapTypeId(mapTypeId) Parâmetros: mapTypeId: MapTypeId|string Valor de retorno: nenhum
setOptions	setOptions(options) Parâmetros: options: MapOptions optional Valor de retorno: nenhum
setRenderingType	setRenderingType(renderingType) Parâmetros: renderingType: RenderingType Valor de retorno: nenhum Define o RenderingType atual do mapa.
setStreetView	setStreetView(panorama) Parâmetros: panorama: StreetViewPanorama optional: o panorama a ser vinculado ao mapa. Valor de retorno: nenhum Vincula um StreetViewPanorama ao mapa. Esse panorama substitui o StreetViewPanorama padrão, permitindo que o mapa se vincule a um panorama externo fora dele. Definir o panorama como null vincula o panorama incorporado padrão de volta ao mapa.
setTilt	setTilt(tilt) Parâmetros: tilt: number Valor de retorno: nenhum Para mapas vetoriais, define o ângulo de incidência do mapa. Os valores permitidos são restritos dependendo do nível de zoom do mapa. Para mapas rasterizados, controla o comportamento de alternância automática do ângulo de incidência do mapa. Os únicos valores permitidos são 0 e 45. setTilt(0) faz com que o mapa sempre use uma visualização aérea de 0°, independentemente do nível de zoom e da janela de visualização. setTilt(45) faz com que o ângulo de inclinação mude automaticamente para 45 sempre que imagens em 45° estiverem disponíveis para o nível de zoom e a janela de visualização atuais, e volte para 0 quando não houver imagens em 45° disponíveis (esse é o comportamento padrão). As imagens em 45° estão disponíveis apenas para os tipos de mapa satellite e hybrid, em alguns locais e níveis de zoom. Observação: getTilt retorna o ângulo de inclinação atual, não o valor definido por setTilt. Como getTilt e setTilt se referem a coisas diferentes, não use bind() na propriedade tilt. Isso pode gerar efeitos imprevisíveis.
setTiltInteractionEnabled	setTiltInteractionEnabled(tiltInteractionEnabled) Parâmetros: tiltInteractionEnabled: boolean Valor de retorno: nenhum Define se as interações de inclinação estão ativadas. Essa opção só é válida quando o mapa é vetorial. Se não for definida no código, a configuração de nuvem do ID do mapa será usada (se disponível).
setZoom	setZoom(zoom) Parâmetros: zoom: number Valores de zoom maiores correspondem a uma resolução mais alta. Valor de retorno: nenhum Define o zoom do mapa.
Herdado: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interface MapOptions

interface google.maps.MapOptions

Objeto MapOptions usado para definir as propriedades que podem ser definidas em um mapa.

Interface MapTypeStyle

interface google.maps.MapTypeStyle

O MapTypeStyle é uma coleção de seletores e estilizadores que definem como o mapa deve ser estilizado. Os seletores especificam os recursos e/ou elementos do mapa que serão afetados, e os stylers especificam como esses recursos e elementos serão modificados. Para mais detalhes, consulte a referência de estilo.

Interface MapMouseEvent

interface google.maps.MapMouseEvent
estendida por Data.MouseEvent, FeatureMouseEvent, IconMouseEvent, PolyMouseEvent

Esse objeto é retornado de diversos eventos do mouse no mapa e de sobreposições, e contém todos os campos mostrados abaixo.

Interface IconMouseEvent

interface google.maps.IconMouseEvent extends MapMouseEvent

Esse objeto é enviado em um evento quando um usuário clica em um ícone no mapa. O ID de lugar deste lugar é armazenado no membro placeId. Para impedir que a janela de informações padrão apareça, chame o método stop() nesse evento para evitar que ele seja propagado. Saiba mais sobre os IDs de lugar no guia para desenvolvedores da API Places.

Constantes ColorScheme

constantes google.maps.ColorScheme
biblioteca "core"

Identificadores para esquemas de cores do mapa. Especifique-os por valor ou usando o nome da constante. Por exemplo, 'FOLLOW_SYSTEM' ou google.maps.ColorScheme.FOLLOW_SYSTEM.

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo ColorSchemeString.

const {ColorScheme} = await google.maps.importLibrary("core");

Constantes MapTypeId

constantes google.maps.MapTypeId
biblioteca "maps"

Identificadores para MapTypes comuns. Especifique-os por valor ou usando o nome da constante. Por exemplo, 'satellite' ou google.maps.MapTypeId.SATELLITE.

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo MapTypeIdString.

const {MapTypeId} = await google.maps.importLibrary("maps");

Classe MapTypeRegistry

classe google.maps.MapTypeRegistry estende MVCObject
biblioteca "maps"

Um registro para instâncias MapType, com chave por ID MapType.

const {MapTypeRegistry} = await google.maps.importLibrary("maps");

Interface MapRestriction

interface google.maps.MapRestriction

Uma restrição que pode ser aplicada ao mapa. A janela de visualização do mapa não vai exceder essas restrições.

Classe TrafficLayer

classe google.maps.TrafficLayer estende MVCObject
biblioteca "maps"

Uma camada para dados do trânsito.

const {TrafficLayer} = await google.maps.importLibrary("maps");

Interface TrafficLayerOptions

interface google.maps.TrafficLayerOptions

Objeto TrafficLayerOptions usado para definir as propriedades que podem ser definidas em um TrafficLayer.

Classe TransitLayer

classe google.maps.TransitLayer estende MVCObject
biblioteca "maps"

Uma camada de transporte público.

const {TransitLayer} = await google.maps.importLibrary("maps");

Classe BicyclingLayer

classe google.maps.BicyclingLayer estende MVCObject
biblioteca "maps"

Uma camada que mostra ciclovias.

const {BicyclingLayer} = await google.maps.importLibrary("maps");

Interface CameraOptions

interface google.maps.CameraOptions
estendida por CameraParams

Usado para definir as opções de câmera do mapa.

Interface VisibleRegion

interface google.maps.VisibleRegion

Contém os quatro pontos que definem o polígono de quatro lados que é a região visível do mapa. Em um mapa vetorial, esse polígono pode ser um trapézio em vez de um retângulo, quando o mapa tem inclinação.

Constantes RenderingType

constantes google.maps.RenderingType
biblioteca "maps"

Essas constantes também podem ser usadas como strings. No TypeScript, os literais de string são definidos pelo tipo RenderingTypeString.

const {RenderingType} = await google.maps.importLibrary("maps");

Interface MapCapabilities

interface google.maps.MapCapabilities

Objeto que contém um snapshot dos recursos disponíveis no momento para o mapa. Isso não significa necessariamente que os módulos relevantes foram carregados ou inicializados, mas sim que o mapa atual tem permissão para usar essas APIs. Consulte as propriedades para ver uma lista de recursos possíveis.