Notas da versão da API Maps JavaScript

Inscreva-se para receber essas notas da versão. Inscrever-se

A equipe da API Maps JavaScript atualiza a API regularmente com novos recursos, correções de bugs e melhorias na performance. Especifique a versão da API a ser carregada no seu aplicativo no parâmetro v da solicitação de inicialização da API Maps JavaScript. Leia mais sobre o controle de versões.

Este registro de alterações lista as versões por data e número, além das mudanças associadas.

Esta página lista as notas de versão de 2025 e 2026. Para versões anteriores, consulte o arquivo de notas da versão da API Maps JavaScript.

Para receber atualizações sobre novas versões da API Maps, inscreva-se no grupo google-maps-js-api-v3-notify.

3.66.9d

14 de outubro de 2026

Mudanças:

  • Correção de um problema em que a conclusão de um arrasto em um AdvancedMarkerElement acionava erroneamente um evento de clique no mapa.
  • Correção da janela de informações do PDIs que não fechava com a tecla Escape depois de reabrir o mesmo PDI.
  • [Canal Alfa] AdvancedPlaceDetailsElement, AdvancedPlaceDetailsCompactElement e AdvancedPlaceItemElement agora oferecem suporte aos slots basic-section-top e basic-section-bottom no canal Alfa.
  • [canal Alfa] PlacePinElementjá disponível no canal Alfa para mostrar informações de lugares em um mapa
  • Correção do problema em que o InfoWindow não fechava com a tecla Escape e o foco não retornava ao elemento focado anteriormente quando o mapa era um elemento gmp-map.

3.66.8b

8 de outubro de 2026

Mudanças:

  • Correção da janela de informações do PDI que não fechava com a tecla Escape depois que o ícone do PDI era clicado novamente.
  • Correção da navegação com as teclas de seta do teclado que movia o foco para AdvancedMarkerElements fora da área visível do mapa.
  • [Canal Beta] Adicionamos MapMode.ROADMAP, o controle de interface do modo mapa, Map3DElement.colorScheme (para estilização de mapa claro e escuro) e Label3DElement (<gmp-label-3d>) aos mapas 3D (Map3DElement).

3.66.7

1º de outubro de 2026

Mudanças:

  • [Canal Alfa] Correção dos ícones de veículos de transporte público no popover Route3DElement que desapareciam no modo de cores forçadas.
  • [Canal Alfa] O Route.createWaypointMarkers() agora define um title padrão localizado ("Origem" ou "Destino") nos marcadores que cria.
  • [Canal Alfa] Correção do texto popover do Route3DElement que ficava invisível nos modos de mapa híbrido e de satélite.
  • [Canal Alfa] Os marcadores 3D criados por Route.createWaypointMarkers() agora mantêm um tamanho de tela constante (sizePreserved é true por padrão).
  • [Canal Alfa] Os marcadores de origem e destino de Route3DElement agora podem ser acessados com o teclado e são anunciados por leitores de tela. Ao passar o cursor sobre um marcador, o título dele aparece como uma dica.
  • [Canal Beta] Adicionamos as propriedades Map3DElement.maxMemoryMegabytes e Map3DElement.qualityMode, além do tipo enumerado QualityMode, para ajudar a reduzir o uso da memória do mapa 3D.
  • Correção de um problema em que PopoverElement (<gmp-popover>) saía da âncora ao mudar o zoom da página no Safari.
  • Adicionamos suporte a eventos de ponteiro usando gmp-pointerover, gmp-pointerout e gmp-pointermove para elementos interativos no Maps3D.
  • As definições do TypeScript foram corrigidas para que os elementos de desenho do Maps 3D (Marker3DElement, Model3DElement, Polygon3DElement, Polyline3DElement, FlattenerElement, CirclePathElement) e PopoverElement aceitem google.maps.LatLng.

3.66.6c

22 de setembro de 2026

Mudanças:

  • Correção de um problema em que o PlaceAutocompleteElement não mostrava o botão de limpar quando preenchido de forma programática usando as opções do construtor ou a propriedade de valor.
  • [canal Alfa] colorScheme foi removido de google.maps.routes.RoutePolyline3DOptions. O Route3DElement agora rastreia o esquema de cores efetivo do Map3D pai.
  • [Canal Beta] Corrigimos o vazamento de memória no ciclo de vida de renderização do panorama do Street View.
  • [canal Beta] Os ícones padrão do PlaceLinkElement podem ser ocultados com o atributo default-icon-hidden, permitindo links de lugares somente com texto.

3.66.4d

9 de setembro de 2026

Mudanças:

  • [Canal Alfa] O alcance mínimo de AutofitsCamera mudou de 2.000 para 80 metros.
  • O uso de AdvancedMarkerElement.addListener() e eventos legados (click, dragstart, drag, dragend) foi descontinuado. Use o addEventListener() padrão com eventos prefixados com gmp-.

3.66.3d

2 de setembro de 2026

Mudanças:

  • [canal Alfa] Adicionamos o campo trafficPolylinesDisabled a RoutePolyline3DOptions. Isso permite que os desenvolvedores desativem as polilinhas que mostram o trânsito ao criar polilinhas de trajeto em 3D.
  • [canal Alfa] Otimização do Route3DElement para evitar solicitações desnecessárias de back-end ao alternar trafficPolylinesDisabled.

3.66.2d

26 de agosto de 2026

Mudanças:

  • [canal Alfa] Os ícones de rota em 3D foram removidos do carregamento de fontes e movidos para recursos SVG incorporados para evitar complicações ao carregar a fonte do Material Symbols mais de uma vez.
  • [canal Beta] Adiciona componentes avançados do kit de interface do Places: AdvancedPlaceDetailsElement, AdvancedPlaceDetailsCompactElement, PlaceLinkElement, PlaceButtonElement, PlaceNameElement, AdvancedPlaceListElement, AdvancedPlaceSearchElement
  • Adicionamos uma dica aos nomes das linhas de transporte público para que o nome completo seja exibido mesmo quando estiver truncado.
  • Adição de tipagens removeEventListener para componentes personalizados da Web.
  • Correção de um problema em que o VoiceOver mostrava um contorno de foco em elementos do leitor de tela visualmente ocultos para marcadores de trajeto.

3.66.1a

17 de agosto de 2026

Mudanças:

  • Corrigimos o comportamento de acessibilidade das imagens estáticas do card de lugar adicionando rótulos substitutos e removendo paradas redundantes de foco do teclado.

3.65.12f

6 de agosto de 2026

Mudanças:

  • [canal Alfa] Adiciona <gmp-label-3d> (google.maps.maps3d.Label3DElement) ao canal Alfa da API 3D Maps JS. Agora os desenvolvedores podem usar o novo elemento para declarar o texto do rótulo e configurar o comportamento em caso de conflito de forma independente dos elementos de marcador 3D vinculados (como <gmp-marker-3d> e <gmp-marker-3d-interactive>).
  • Forneça nomes acessíveis exclusivos para os botões "Mais opções" nos widgets do Place Details.
  • [canal Alfa] Melhoria nas mensagens de erro do modo de trajeto em 3D para quando TravelMode.TWO_WHEELER é usado fora do Alfa/Beta.
  • [canal Alfa] O componente Route3D agora é compatível com a propriedade trafficPolylinesDisabled. Isso permite que os desenvolvedores desativem as polilinhas que mostram o trânsito ao usar as opções de trajeto TRAFFIC_AWARE ou TRAFFIC_AWARE_OPTIMAL.
  • [canal Alfa] O padding dos limites ao norte do AutofitsCamera foi aumentado para evitar o corte padrão do alfinete.
  • Correção de um problema em que o Pegman do Street View não podia ser arrastado para o mapa em dispositivos com touch screen.

3.65.11b

27 de julho de 2026

Mudanças:

  • [canal Alfa] Pop-over do Route3D aprimorado para mostrar ícones não transitivos (bicicleta, carro, veículo de duas rodas e caminhada).
  • [canal Alfa] Route.createWaypointMarkers cria marcadores para a origem e o destino, com o estilo padrão aplicado, a menos que uma função customOverride seja especificada. No momento, não há suporte para waypoints intermediários.

3.65.10a

22 de julho de 2026

Mudanças:

  • Corrigimos um problema em que o Maps JS carregava a fonte Material Symbols Outlined de uma forma que poderia afetar a mesma fonte carregada na página de base.
  • Correção de um problema em que PlaceAutocompleteElement enviava um valor vazio no POST do formulário quando inicializado com options.value ou modificado de forma programática pela propriedade value.
  • Atualizamos os controles de interface de inclinação e direção do mapa 3D para que sejam reativados se o intervalo de restrição da câmera for aumentado.

3.65.8c (revertida)

7 de julho de 2026

Mudanças:

  • [canal Alfa] O Route3DElement renderiza mais dados de polilinhas e pop-overs para rotas de transporte público.
  • Adicionamos suporte para internalUsageAttributionIds à API Address Validation. Essa propriedade permite a atribuição de chamadas de API a pacotes ou bibliotecas de OSS específicos.
  • Atualizamos a janela de informações padrão para cliques em PDIs em mapas 2D para usar os Place Widgets.
  • Melhoramos a confiabilidade dos panoramas do Street View em condições de trânsito intenso.

3.65.6a

25 de junho de 2026

Mudanças:

  • [Canal Beta] Atualizamos a janela de informações padrão para cliques em PDIs em mapas 2D para usar os Place Widgets.
  • Correção de um bug em que o mapa 3D às vezes gerava um erro em valores extremos de fov.
  • Os marcadores de rota padrão foram atualizados para não usar mais a opção glyph PinElement descontinuada.

3.65.5e

17 de junho de 2026

Mudanças:

  • Correção de digitação para OverlayView.getMap()
  • Atualizamos as tipagens de BasicPlaceAutocompleteElement e PlaceAutocompleteElement para indicar que o parâmetro de opções do construtor é opcional.

3.65.3b

4 de junho de 2026

Mudanças:

  • A funcionalidade DrawingManager na API Maps JavaScript não está mais disponível. Para mais informações, acesse https://developers.google.com/maps/deprecations.
  • Melhoria no contraste de cores da caixa de diálogo de direitos autorais do mapa no modo escuro.
  • Desative os controles de rotação do mapa 3D quando os limites de direção forem atingidos.
  • Correção de um problema em que o campo de entrada para dispositivos móveis do Place Autocomplete se sobrepunha à barra de status/área segura do sistema iOS. Observação: a correção funciona quando viewport-fit=cover é definido na metatag viewport.
  • Adicionamos suporte a internalUsageAttributionIds à API Maps 3D JavaScript. Essa propriedade permite que os desenvolvedores atribuam chamadas de API a pacotes ou bibliotecas de OSS específicos.
  • Adicionamos suporte a internalUsageAttributionIds à API Places (nova). Essa propriedade permite que os desenvolvedores atribuam chamadas de API a pacotes ou bibliotecas de OSS específicos.
  • [Canal Alfa] Os tipos de getter das propriedades de Route3DElement foram limitados para corresponder à normalização do setter.
  • [Canal Alfa] Route3DElement expõe as propriedades routes, fallbackInfo e geocodingResults.

3.65.2d

27 de maio de 2026

Mudanças:

  • Corrigimos um problema com o botão de zoom ao diminuir o zoom em um mapa com limites restritos.
  • A biblioteca Places introduziu transitStation em lugares.
  • Adicionamos suporte para internalUsageAttributionIds na biblioteca Routes. Essa propriedade permite que os desenvolvedores atribuam chamadas de API a pacotes ou bibliotecas de OSS específicos.

3.65.1c

20 de maio de 2026

Mudanças:

  • O logotipo do Google agora será cinza-escuro em um fundo branco para o Roadmap e o Terrain no modo claro, independentemente de um ID de mapa ou estilo personalizado ser fornecido.
  • [canal Alfa] O Route3DElement envia eventos gmp-load e gmp-error após chamadas de API Routes bem-sucedidas e com erro, respectivamente.
  • Corrigimos a documentação incorreta que afirmava que as correspondências são destacadas no texto secundário das previsões de preenchimento automático. As correspondências são destacadas apenas no texto principal, refletindo o comportamento do preenchimento automático da API Places.
  • Melhoramos a herança de cores para itens de previsão de preenchimento automático do Place Autocomplete, de modo que eles herdem de forma adequada a cor definida no elemento pai.
  • Adicionamos os slots "input-icon" e "clear-icon" a PlaceAutocompleteElement e BasicPlaceAutocompleteElement para personalização de ícones.
  • Partes de sombra prediction-item-secondary-text e prediction-item-nonmatch expostas para itens de previsão BasicPlaceAutocomplete e PlaceAutocomplete, permitindo o estilo personalizado para texto principal e secundário não correspondentes.
  • Adição do atributo no-clear-button e da propriedade noClearButton a PlaceAutocompleteElement e BasicPlaceAutocompleteElement para permitir que o botão de limpar seja ocultado.
  • A funcionalidade de camada de mapa de calor na API Maps JavaScript foi desativada.
  • Melhoria no tratamento de erros para recuperação da configuração do mapa.
  • As imagens em 45° foram desativadas para mapas rasterizados.
  • Adicionamos as classes que faltavam à documentação da PlacesLibrary. Também documentamos o método toString() em FormattableText.
  • Melhoramos a acessibilidade dos links "Informar erro no mapa".

3.64.12d

6 de maio de 2026

Mudanças:

  • O método equals() de LatLng agora aceita objetos LatLngLiteral em vez de gerar um erro. A documentação de LatLng e LatLngAltitude equals() agora também reflete com precisão o nível de tolerância atual de 1e-9.
  • [Canal Alfa] O Map3DElement com filhos de ajuste automático agora é renderizado inicialmente com o modo de altitude RELATIVE_TO_GROUND, que permite mostrar áreas de maior elevação no carregamento quando as propriedades da câmera são predefinidas, em vez de aplicadas usando flyCameraTo. Além disso, no carregamento inicial de Map3DElement, se o mapa tiver filhos que usam a API AutofitsCamera e ainda estiverem funcionando, a renderização inicial do mapa será adiada até que todos terminem de funcionar, e a câmera será ajustada independentemente da configuração de animação de sobrevoo. As atualizações subsequentes da câmera respeitam a configuração de sobrevoo.
  • [Canal Alfa] O Polygon3DElement adiciona a propriedade autofitsCamera para oferecer suporte ao ajuste automático da câmera.

3.64.11d

29 de abril de 2026

Mudanças:

  • [canal Alfa] MarkerElement adiciona a propriedade autofitsCamera para que a câmera se ajuste automaticamente ao marcador.
  • Correção de um problema no PlaceAutocompleteElement em que o ícone do item de previsão não era renderizado no navegador Safari.
  • A biblioteca Places introduziu isPureServiceAreaBusiness em lugares. Agora é possível solicitar resultados para empresas que atendem apenas em uma área de serviço definindo pureServiceAreaBusinessesIncluded nas solicitações do Place Autocomplete (API de dados e widgets) e do Text Search.
  • A biblioteca Places introduziu addressDescriptor, containingPlaces e timeZone em lugares.
  • A biblioteca Places introduziu futureOpeningDate em lugares. Agora é possível solicitar resultados para empresas que ainda não abriram definindo futureOpeningBusinessesIncluded nas solicitações do Place Autocomplete (API de dados e widgets), do Nearby Search e do Text Search.
  • O logotipo do Google agora será o mesmo para o Roadmap claro, com ou sem um ID de mapa ou estilo personalizado. Antes, mostrávamos o logotipo do Google no modo escuro para todos os mapas do Roadmap que usavam um ID de mapa. Para manter o logotipo branco do Google, os usuários precisam mudar para o modo escuro.
  • Adicionamos o focus-ring como parte de sombra CSS em PlaceAutocompleteElement e BasicPlaceAutocompleteElement.
  • Adicionamos novas FuelType DIESEL_PLUS e E100. Adicionamos um novo EVConnectorType NACS.
  • Adicionamos os atributos value, placeholder, disabled, readonly, no-input-icon e maxlength a PlaceAutocompleteElement e BasicPlaceAutocompleteElement.
  • Adicionamos uma propriedade "description" a PlaceAutocompleteElement e BasicPlaceAutocompleteElement para fornecer mais contexto aos usuários de leitores de tela.
  • Restringimos o tipo declarado de LatLngAltitudeLiteral.altitude para não permitir valores nulos ou indefinidos. Correção do tipo de retorno declarado de DirectionalLocation.toJSON().

3.64.9c

14 de abril de 2026

Mudanças:

  • As declarações do TypeScript agora diferenciam corretamente os tipos de getters e setters de propriedades (incluindo propriedades somente leitura sem setters).

3.64.8b

8 de abril de 2026

Mudanças:

  • [canal Alfa] Route3DElement, Marker3DElement e Polyline3DElement com autofitsCamera não vão causar atualizações da câmera quando forem removidos do DOM. Para Route3DElement, erros ou respostas vazias não afetam a câmera. Além disso, mudar autofitsCamera de verdadeiro para falso em um determinado elemento não atualiza a câmera para excluir esse elemento, mas o exclui de futuras atualizações da câmera.
  • O zIndex de um AdvancedMarkerElement agora é determinado pelo valor definido explicitamente ou, por padrão, pela posição vertical em pixels. Os valores explícitos têm precedência sobre o padrão. Para evitar que marcadores mais abaixo na tela sem um zIndex se sobreponham inesperadamente aos que têm um, recomendamos aplicar zIndex de forma consistente em todos os marcadores.
  • As declarações do TypeScript agora incluem uma interface que mapeia nomes de tags HTML para classes JS (google.maps.HTMLElementTagNameMap e o HTMLElementTagNameMap global), uma interface que mapeia nomes de tags HTML para o EventMap de cada classe JS (google.maps.HTMLElementEventMapTagNameMap), uma interface de todas as propriedades CSS personalizadas (google.maps.CSSProperties) e cada tipo enumerado baseado em string tem um tipo de união de strings definido (como ${EnumName}String), que é usado para esse tipo enumerado em todas as declarações. addEventListener() também é sobrecarregado em cada elemento personalizado com os tipos EventMap, e google.maps.importLibrary() é sobrecarregado para digitar corretamente cada biblioteca retornada para o nome da biblioteca transmitida.

3.64.7d

1º de abril de 2026

Mudanças:

  • A propriedade mapId agora pode ser atualizada dinamicamente após a inicialização de Map3DElement, eliminando a necessidade de reinstanciar Map3DElement.
  • [canal Alfa] Adicionamos um novo Route3DElement para renderizar trajetos em mapas 3D.
  • [Canal Alfa] Adicionamos as novas APIs Route.create3DPolylines() e Route.createPopover().
  • [Canal Alfa] Adição de uma nova API spherical.traversePath().
  • [Canal Alfa] Adicionamos uma nova API autofitsCamera a Marker3DElement, Polyline3DElement e Route3DElement, com uma nova API autofitsCameraAnimation para Map3DElement.
  • [canal Alfa] Adicionamos um novo CirclePathElement para renderizar círculos com Polygon3DElement.
  • [canal Alfa] Um novo modo de mapa ROADMAP já está disponível nos mapas 3D no canal alpha.
  • Correção de um bug em que o bonequinho do Street View não funcionava corretamente em dispositivos móveis quando estava em um mapa anexado a um elemento DOM criado em um contexto de frame diferente do código da biblioteca Maps JS.

3.64.6d

26 de março de 2026

Mudanças:

  • Correção de um problema em que pressionar Enter não enviava um formulário contendo elementos do Place Autocomplete se nenhuma previsão estivesse destacada.
  • Correção de uma disputa que impedia o FlattenerElement de desenhar em mapas 3D.
  • Correção de um bug em que o processamento de toque em dispositivos móveis não funcionava corretamente quando um mapa era anexado a um elemento DOM criado em um contexto de iframe diferente do código da biblioteca JS do Maps.

3.64.5d

18 de março de 2026

Mudanças:

  • O canal weekly agora conta com várias atualizações de mapas em 3D, incluindo as novas MarkerElement e FlattenerElement. Além disso, adicionamos as propriedades cameraPosition e fov, além de suporte a altitudeMode para os métodos flyCameraTo e flyCameraAround.
  • A biblioteca Places introduziu currentOpeningHours, regularSecondaryOpeningHours e currentSecondaryOpeningHours para lugares identificados. O currentOpeningHours informa o horário de funcionamento da próxima semana, incluindo horários excepcionais, como feriados. O horário de funcionamento secundário é diferente do principal e indica o horário de funcionamento de serviços como drive-through, retirada ou entrega.
  • Corrigimos um problema nos mapas 3D em que o link para o Google Maps às vezes não era atualizado corretamente após a movimentação do mapa.

3.64.4d

12 de março de 2026

Mudanças:

  • Sincronização da propriedade do mapa InfoWindow na mudança de posição para corrigir o problema que causava avisos desnecessários no console.
  • Correção de um problema em que as atualizações programáticas de fov para Map3DElement eram descartadas ocasionalmente.
  • O método flyCameraAround em Map3DElement agora aceita Number.Infinity para o parâmetro repeatCount, permitindo uma animação infinita.

3.64.3a

2 de março de 2026

Mudanças:

  • A API Maps Embed agora usa o Kit de Interface do Places para mostrar Place Details.
  • [canal Beta] A propriedade cameraPosition introduzida anteriormente em Map3DElement na versão 3.64.2 agora também é compatível com o destino flyCameraTo. Consulte Mapas 3D no Maps JavaScript para mais informações.

3.64.2b

26 de fevereiro de 2026

Mudanças:

  • google.maps.DirectionsService, google.maps.DirectionsRenderer e google.maps.DistanceMatrixService foram descontinuados em 25 de fevereiro de 2026. No momento, não há previsão de desativação, e eles vão continuar recebendo correções de bugs para regressões importantes. Haverá um aviso prévio de pelo menos 12 meses antes que o suporte seja descontinuado. Consulte legado para mais detalhes (incluindo alternativas mais recentes e recomendadas).
  • [Canal Beta] Introduzimos um novo MarkerElement que permite mostrar conteúdo HTML personalizado em marcadores no mapa 3D. Além disso, um novo FlattenerElement agora pode nivelar malhas 3D em áreas específicas.
  • [canal Beta] Map3DElement foi atualizado com as propriedades fov e cameraPosition, enquanto os métodos flyCameraTo e flyCameraAround agora são compatíveis com altitudeMode. Consulte Mapas 3D no Maps JavaScript para mais informações.
  • Correção de um bug que fazia com que a criação de um PinElement usando document.createElement('gmp-pin') gerasse um NotSupportedError.

3.64.1c

19 de fevereiro de 2026

Mudanças:

  • Atualização da colisão quando o AdvancedMarkerElement é redimensionado.

3.63.14d

5 de fevereiro de 2026

Mudanças:

  • A biblioteca Places introduziu novas opções para identificar um lugar ao solicitar dados. Além de usar id, agora é possível especificar um resourceName para inicializar um objeto Place.
  • A biblioteca Places introduziu subDestinations para lugares identificados. Esses subDestinations fornecem destinos mais específicos para usuários que estão pesquisando em um lugar grande ou complexo, como um aeroporto, parque nacional, universidade ou estádio.
  • Corrigimos um problema em que o Map3D exigia que uma altitude fosse especificada ao definir a propriedade central em JS (agora o padrão é 0).
  • O objeto Place de PlaceDetailsElement e PlaceDetailsCompactElement agora inclui uma propriedade googleMapsLinks, que fornece URLs para links diretos no Google Maps para várias ações. Isso inclui URIs para ver o lugar, receber rotas, ver fotos, ler avaliações atuais e escrever uma nova avaliação.

3.63.13

29 de janeiro de 2026

Mudanças:

  • A API Maps Embed não mostra mais cartões de informações ao colocar o cursor do mouse sobre PDIs.
  • Adiciona avisos do console para elementos do Kit de Interface do Places (Place Details + Place Search) configurados incorretamente.
  • O PlaceDetailsElement agora mostra resumos de lugares gerados com IA, quando disponíveis.
  • Um resumo das avaliações gerado com IA agora está disponível para o PlaceDetailsElement.

3.63.10a

13 de janeiro de 2026

Mudanças:

  • Correção de um problema que impedia gestos de rolagem e clique em popovers.
  • Os campos resourceName e shortFormattedAddress agora estão disponíveis na API Places.

3.63.9d

8 de janeiro de 2026

Mudanças:

  • O PlaceSearchElement mostra o conteúdo que não é de fotos um pouco mais rápido enquanto as fotos estão carregando. As animações de esmaecimento de fotos foram refinadas no Kit de Interface do Places.
  • Melhoria no desempenho ao renderizar polilinhas em um mapa inclinado.
  • Correção de um bug em que a câmera do mapa 3D não era atualizada quando definida de forma programática em determinadas condições.
  • Pequena melhoria de desempenho ao carregar fotos para PlaceDetailsElement e PlaceSearchElement.
  • Esclarecemos o comportamento da propriedade draggable em MapOptions para explicar melhor as restrições de interação do usuário.
  • Impõe o acesso ao canal Beta para possibleNextAction na biblioteca Address Validation
  • Adição de suporte à propriedade placeholder e ao atributo HTML para PlaceAutocompleteElement
  • PlaceAutocompleteElement agora oferece suporte à personalização de mais propriedades de fonte CSS padrão, incluindo: font, font-size, font-family, font-weight, line-height, font-style e color. O tamanho de fonte padrão agora é 16px.
  • Adição de suporte à propriedade value e ao atributo HTML para PlaceAutocompleteElement
  • Otimização do carregamento de imagens no Kit de Interface do Places.
  • Adicionamos a parte CSS input ao PlaceAutocompleteElement.

3.63.5d

11 de dezembro de 2025

Mudanças:

  • Lança a API Address Validation na API Maps JavaScript
  • mapTypeId agora usa MapTypeId.ROADMAP como padrão quando definido como nulo ou indefinido, corrigindo um problema que poderia impedir o carregamento de blocos de mapa.
  • Ocultar a seção de avaliações em PlaceDetailsElement se o lugar não puder ser avaliado.
  • Contraste de cores aprimorado para o logotipo do Google mostrado em google.maps.Map com estilo personalizado
  • Os mapas vetoriais agora usam as mesmas imagens de satélite que os mapas rasterizados, o que permite uma maior fidelidade visual.

3.63.4a

4 de dezembro de 2025

Mudanças:

  • --gmp-mat-spacing-medium agora se aplica ao padding do contêiner interno para a visualização horizontal de PlaceDetailsCompactElement.
  • Corrigimos um problema com a mudança do mapa em 3D no Safari do MacOS ao interagir com os controles de interface.
  • As propriedades language e region agora podem ser alteradas dinamicamente em Map3DElement sem a necessidade de recriar um mapa.

3.63.1b

20 de novembro de 2025

Mudanças:

  • Correção de um problema em que a janela de informações era posicionada incorretamente quando anexada a um AdvancedMarkerElement.
  • O botão de limpar do PlaceAutocompleteElement agora só fica visível quando a entrada tem texto.
  • A correspondência do atributo de orientação não diferencia maiúsculas de minúsculas nos estilos PlaceDetailsCompactElement.
  • Adicionamos uma opção para desativar a movimentação do mapa quando PopoverElement está aberto no Maps 3D.
  • Correção de um bug que impedia o uso de addEventListener() no PinElement.
  • As caixas de diálogo modais (como a de atalhos de teclado no mapa e a de declarações no Kit de Interface do Places) agora são fechadas com um clique fora da área de conteúdo.
  • Os dados de lugares agora incluem resumos informativos gerados com IA para avaliações e comodidades próximas. As novas propriedades são evChargeAmenitySummary, neighborhoodSummary, generativeSummary e reviewSummary.

3.62.13e

6 de novembro de 2025

Mudanças:

  • Correção de um problema de vazamento de memória quando um PopoverElement é adicionado e removido dinamicamente do DOM.
  • Correção de um problema de vazamento de memória quando um Map3DElement é adicionado e removido dinamicamente do DOM.
  • Correção do alinhamento dos cantos arredondados da imagem com os cantos arredondados do contêiner ao usar uma borda grossa em PlaceDetailsCompactElement.

3.62.12c

30 de outubro de 2025

Mudanças:

  • [canal Alfa] O ElevationElement experimental foi removido.
  • Adicionamos variáveis CSS para background-color, border-radius, box-shadow e padding ao Map 3D PopoverElement.
  • Os lightboxes de fotos do Kit de Interface do Places não fecham mais quando você clica fora da foto.

3.62.11d

23 de outubro de 2025

Mudanças:

  • [canal Alfa] Fazer o modo escuro funcionar para destacar itens da lista contextual de lugares.
  • As propriedades anchorLeft e anchorTop foram adicionadas a AdvancedMarkerElementOptions.
  • O componente da Web <gmp-pin> já está disponível. Use a nova propriedade glyphSrc para fornecer um URL de imagem para o glifo ou a propriedade glyphText para mostrar o texto. A propriedade glyph foi descontinuada no PinElement.
  • Impede que a InfoWindow apareça inesperadamente quando um AdvancedMarker associado é criado fora da janela de visualização.
  • O 3D Maps já está disponível no canal semanal. Esta versão inclui um novo controle de bússola e controles de interface padrão simplificados, suporte à Estilização de mapas baseada na nuvem e ao processamento de gestos cooperativos, localização aprimorada com novas propriedades language e region no Map3DElement, além de melhorias de acessibilidade para rótulos de mapa básico. Consulte Mapas em 3D na API Maps JavaScript para mais informações.
  • Gerenciamento de memória aprimorado para o Mapa 3D para evitar problemas de memória insuficiente em dispositivos iOS.
  • Lançamento do Routes JS. Permite que os desenvolvedores façam chamadas de API da API Routes e desenhem rotas com a API Maps JS.

3.62.9c

9 de outubro de 2025

Mudanças:

  • As propriedades anchorTop e anchorLeft foram adicionadas à AdvancedMarkerElement. Isso permite mudar o ponto de fixação de um marcador para algo diferente do padrão (parte central inferior).

3.62.8d

2 de outubro de 2025

Mudanças:

  • Novos controles de câmera ativados para a API Maps Embed.
  • [canal Beta] A propriedade defaultUIDisabled na classe Map3DElement e na interface Map3DElementOptions foi substituída por defaultUIHidden. O defaultUIDisabled vai continuar funcionando no canal beta.
  • [canal Beta] A propriedade rounds na interface FlyAroundAnimationOptions foi substituída por repeatCount. O rounds vai continuar funcionando no canal beta.
  • A propriedade mapMode foi descontinuada no PlaceContextualElement.

3.62.7e

25 de setembro de 2025

Mudanças:

  • Ative os marcadores de destaque para PlaceContextualElement.

3.62.6d

18 de setembro de 2025

Mudanças:

  • [canal Beta] Esclarecimento das mensagens de erro do Route.
  • [canal Beta] Suporte a nomes de recursos de lugar em solicitações Route.
  • [canal Beta] Permite criar polilinhas Route de caminhos RouteLeg.

3.62.5d

10 de setembro de 2025

Mudanças:

  • [canal Beta] A propriedade coordinates em Polyline3DElement foi substituída por path, que agora está disponível como um atributo HTML. A propriedade outerCoordinates em Polygon3DElement foi substituída por path, que agora está disponível como um atributo HTML. A propriedade innerCoordinates em Polygon3DElement foi substituída por innerPaths. Todas as propriedades "coordinates" desses dois elementos foram descontinuadas, mas vão continuar funcionando no canal Beta.

3.62.3c

3 de setembro de 2025

Nenhuma mudança voltada ao público.

3.62.2c

28 de agosto de 2025

Mudanças:

3.62.1

21 de agosto de 2025

Mudanças:

  • [Canal Beta] Adicionamos sessionToken e placeAutocompleteElement como opções para a API Address Validation para gerenciamento de sessões em AddressValidation.fetchAddressValidation().
  • [Canal Beta] Lançamento do Routes JS. Permite que os desenvolvedores façam chamadas de API da API Routes e desenhem rotas com a API Maps JS.

3.61.14

7 de agosto de 2025

Mudanças:

  • Correção de um problema em que o lightbox de fotos não estava disponível no elemento compacto de Place Details no modo horizontal.

3.61.12c

31 de julho de 2025

Mudanças:

  • Adicionamos documentação para outros campos em PlaceAutocompleteElementOptions e BasicPlaceAutocompleteElementOptions.
  • Resolvemos um problema em que os Marcadores Avançados piscavam brevemente e depois desapareciam quando eram movidos para fora da tela.
  • Adicionamos googleMapsLinks à classe Place.

3.61.11a

24 de julho de 2025

Mudanças:

  • Adicionamos originalText e originalTextLanguageCode à classe Place Review.
  • [canal Alfa] Ative o mapMode para o widget de embasamento do PlaceContextual Maps. Permite que os usuários alternem entre ROADMAP, HYBRID e NONE.
  • [Canal Beta] O Map3DElement agora dispara um evento se o mapa não for inicializado, por exemplo, devido à falta de suporte ao WebGL no navegador do usuário.
  • As imagens em 45° no mapa foram descontinuadas. Consulte Descontinuações – Imagens em 45° para mais informações.

3.61.10d

17 de julho de 2025

Mudanças:

  • O widget básico do Place Autocomplete já está disponível no canal semanal.
  • [canal Alfa] Remoção do PlaceListElement experimental.
  • Adicione PlaceSearchElement e os elementos de configuração / solicitação associados.
  • Tokens de estilo adicionais para PlaceDetailsElement e PlaceDetailsCompactElement.

3.61.9a

10 de julho de 2025

Mudanças:

  • Atualizamos os marcadores para evitar instruções de navegação repetidas em cada item ao usar um leitor de tela. Agora, a instrução é anunciada apenas uma vez ao entrar no grupo.
  • Corrigimos um problema de contraste na caixa de diálogo de atalhos do teclado no modo escuro.
  • Ative o suporte à personalização de borda, raio da borda, cor de fundo do widget e esquema de cores para o elemento Place Autocomplete. O elemento Place Autocomplete agora respeita automaticamente o modo escuro. Para desativar, aplique color-scheme: light no CSS.
  • Adição de campos googleMapsURI às classes Place Photo e Review.
  • [Canal Beta] Adição do tipo enumerado PossibleNextAction à API Address Validation.

3.61.7a

1º de julho de 2025

Mudanças:

  • A funcionalidade da camada de mapa de calor na API Maps JavaScript não é mais compatível. Essa API foi descontinuada em maio de 2025 e vai ficar indisponível em uma versão posterior da API Maps JavaScript, que será lançada em maio de 2026. Para mais informações, acesse https://developers.google.com/maps/deprecations.
  • Correção de um problema na GA que impedia o processamento de cliques em PDIs ocultos por estilo personalizado.
  • [Canal Beta] Adicionamos um tratamento extra para a perda de contexto do WebGL em mapas 3D. Os mapas 3D agora vão tentar se restaurar quando o contexto do WebGL for restaurado.

3.61.6d

26 de junho de 2025

Mudanças:

  • Adicionamos internalUsageAttributionIds a Map3DElement e Map3DElementOptions.

3.61.5a

17 de junho de 2025

Mudanças:

  • Ative o suporte para a string "IP_BIAS" em LocationBias para o Place Autocomplete.
  • Correção de um erro de documentação para SearchNearbyRequest. O valor padrão de SearchNearbyRequest.RankPreference é POPULARITY, não DISTANCE.

3.61.4a

12 de junho de 2025

Mudanças:

  • Adicionamos o tipo enumerado RPCStatus para descrever os códigos de status retornados por determinados serviços da Web.

3.61.3b

5 de junho de 2025

Nenhuma mudança voltada ao público.

3.61.2

29 de maio de 2025

Mudanças:

  • Adicionamos PlaceDetailsElement, PlaceDetailsCompactElement e elementos de configuração associados. Remoção de PlaceDetailsSize.
  • Corrigimos um problema com PlaceAutocompleteElement em que a seleção de uma entrada do IME fazia com que o elemento selecionasse um item de previsão.

3.61.1

22 de maio de 2025

Mudanças:

  • [Canal Beta] Correção de local/janela de visualização ausente na saída de lugar do PlaceDetailsCompactElement.
  • Os detalhes no nível da rua estão disponíveis nas cidades cobertas.

3.60.12

8 de maio de 2025

Mudanças:

  • [Canal Beta] Adicionamos suporte à API Address Validation na API Maps JavaScript.
  • Correção de um problema com chamadas de rede de contextos sem cabeçalhos de origem.

3.60.11 (revertida)

1º de maio de 2025

Mudanças:

  • [canal Beta] Adição de PlaceDetailsCompactElement e elementos de configuração associados.
  • Correção de StreetViewPanoramaOptions.zoomControl = false que não funcionava para mapas do Street View.

3.60.10

24 de abril de 2025

Mudanças:

  • [canal Beta] O 3D Maps já está disponível no canal Beta. Esta versão inclui melhorias de acessibilidade, além de novos elementos interativos para polilinhas, polígonos e modelos 3D. Além disso, um novo PopoverElement já está disponível para mostrar conteúdo HTML personalizado em mapas 3D. Consulte Mapas 3D no Maps JavaScript para mais informações.

3.60.9

17 de abril de 2025

Mudanças:

  • [canal Alfa] Lançamento do PlaceContextualElement para o Experimental sem restrições.
  • [canal Alfa] Os modelos 3D agora são renderizados com uma iluminação baseada na imagem (IBL, na sigla em inglês) por padrão no Maps 3D.

3.60.8

9 de abril de 2025

Mudanças:

  • [canal Beta] A API LocalContext foi completamente removida. A tentativa de instanciar LocalContextMapView agora gera um erro. Consulte https://developers.google.com/maps/deprecations#localcontext-deprecation para mais informações.
  • Correção de um bug que causava um comportamento estranho ao arrastar Marcadores Avançados em dispositivos touchscreen.
  • Aumentamos a opacidade da sobreposição do gerenciamento cooperativo de gestos para que o texto atenda aos requisitos de contraste em todas as áreas do mapa.
  • Adição de suporte a PostalAddress na API Places.
  • Garante que a cobertura regional estática na inicialização tenha o mesmo colorScheme do mapa de base.

3.60.7b

3 de abril de 2025

Mudanças:

  • O widget do Place Autocomplete já está disponível no canal semanal.

3.60.6

27 de março de 2025

Mudanças:

  • Correção de um problema no Safari em que as páginas que usavam overscroll-behavior não rolavam corretamente.
  • Corrigimos a oscilação ao adicionar muitos Marcadores Avançados com o comportamento em caso de conflito ativado.
  • Adicionamos suporte para PriceRange no Places.

3.60.5 (revertido)

20 de março de 2025

Mudanças:

  • Correção de um bug que impedia a rolagem da página ao clicar ou tocar em Marcadores Avançados.
  • Correção de um bug que impedia o funcionamento correto do modo de tela cheia no <gmp-map>.
  • Correção de um bug em que a janela de informações de um Marcador Avançado oculto ainda ficava visível.
  • Os mapas estilizados personalizados no Roadmap não vão perder a estilização personalizada quando a camada de bicicleta for adicionada.

3.60.4

11 de março de 2025

Mudanças:

  • Os estilos personalizados e as cores de fundo são aplicados ao tipo de mapa e ao esquema de cores específicos para os quais o estilo é definido (inicialmente, isso será limitado ao Roadmap e ao Roadmap Dark). A camada de transporte público vai manter qualquer estilo personalizado para o tipo de mapa selecionado.

3.60.3 (revertida)

5 de março de 2025

Mudanças:

  • Correção de um bug que impedia a exibição do painel de rotas.

3.60.2

27 de fevereiro de 2025

Mudanças:

  • Places: adicionamos suporte ao tipo de conector de VE NACS (SAE J3400).
  • Lançamento dos elementos HTML gmp-map e gmp-advanced-marker para GA.

3.60.1

20 de fevereiro de 2025

Mudanças:

  • [canal Alfa] altitudeMode em Polygon3DElement e Polyline3DElement agora tem como padrão CLAMP_TO_GROUND.
  • [canal Alfa] Uma nova opção mode em Map3DElement agora precisa ser definida para que o mapa 3D seja renderizado (dois novos valores HYBRID e SATELLITE estão disponíveis). A opção defaultLabelsDisabled foi removida. Defina mode como HYBRID ou SATELLITE.
  • [canal Beta] A cor de fundo vai voltar ao padrão ou à cor definida em MapOptions se não tiver sido definida especificamente para um tipo de mapa específico.
  • [canal Beta] Os estilos personalizados de rasterização devem ser aplicados apenas ao tipo de mapa ao qual o estilo foi atribuído.
  • Correção de um problema em que os Marcadores Avançados se deslocavam quando arrastados no modo de tela cheia. Também corrigimos um problema com o Pegman do Street View, que tinha um deslocamento quando arrastado no modo de tela cheia.
  • Substitua o controle de zoom padrão pelo novo controle de câmera, que tem botões de panorâmica e zoom.
  • Atualize os ícones do botão de zoom para que fiquem alinhados com os novos ícones do botão de movimentação.

3.59.8

6 de fevereiro de 2025

Mudanças:

  • Agora os clientes podem acessar os valores de TransitFare como texto.
  • [canal Alfa] Lançamento do novo AirQualityMeterElement: <gmp-air-quality-meter>.
  • [Canal Alfa] O uso do PlaceAutocompleteElement agora exige que a API Places (nova) esteja ativada no projeto do Google Cloud. .
  • [Canal Alfa] PlaceAutocompleteElement: o evento gmp-placeselect foi substituído por gmp-select e fornece um objeto PlacePredictionSelectEvent em vez de um objeto PlaceAutocompletePlaceSelect.
  • [Canal Alfa] PlaceAutocompleteElement: o evento gmp-requesterror foi substituído por gmp-error e fornece um objeto Event em vez de um objeto PlaceAutocompleteRequestErrorEvent.
  • [Canal Alfa] PlaceAutocompleteElement: componentRestrictions foi substituído por includedRegionCodes.
  • [Canal Alfa] PlaceAutocompleteElement: types foi substituído por includedPrimaryTypes.

3.59.7

30 de janeiro de 2025

Mudanças:

  • [Canal Beta] As cores de plano de fundo do mapa de vias e do mapa de vias no modo escuro definidas para estilos personalizados precisam ser renderizadas atrás dos blocos e além das margens do mapa.
  • [Canal Beta] Um mapa de vias com estilo personalizado (ou mapa de vias no modo escuro) vai manter o estilo personalizado quando uma camada de transporte público for adicionada, em vez de voltar ao estilo de mapa de base padrão.
  • Os mapas que estão no modo escuro vão permanecer assim quando a camada de transporte público for adicionada.

3.59.6

23 de janeiro de 2025

Nenhuma mudança voltada ao público.

3.59.5

16 de janeiro de 2025

Mudanças:

  • Correção de um bug que causava erros não detectados ao criar um panorama personalizado do Street View.

3.59.4a

9 de janeiro de 2025

Mudanças:

  • Correção de um bug que causava erros não detectados quando a camada de trânsito estava ativada.
  • [Canal Beta] Resolve um problema em que o PlaceAutocompleteElement não dava foco corretamente.
  • [Canal Beta] Os elementos atômicos do mapa serão mostrados em cidades compatíveis com z17 e mais profundas.

Notas de versões anteriores

Para notas da versão de 2024 e anteriores, consulte o arquivo de notas da versão da API Maps JavaScript.