Suspensões de uso

Nesta página, listamos todos os produtos e recursos da Plataforma Google Maps que serão descontinuados. Isso inclui produtos no Maps, Routes e Places.

Como funciona a descontinuação

O período de descontinuação de um produto, recurso ou versão começa na data de anúncio da descontinuação. O produto, o recurso ou a versão continuará disponível durante todo esse período (normalmente 12 meses). Quando ele terminar, o produto, o recurso ou a versão vão ser desativados e não estarão mais disponíveis.

Os proprietários de projetos com endereços de e-mail monitorados recebem notificações proativas sobre mudanças que afetam os projetos deles. Fique sabendo de atualizações importantes, descontinuações e outras mudanças.

Descontinuações nas versões de SDK

Nos SDKs e na API Maps JavaScript, as descontinuações de recursos estão associadas à disponibilidade das versões. As novas versões principais incluem alterações interruptivas, como a descontinuação de recursos, e as notas indicam a versão máxima aceita de cada recurso descontinuado. Continue usando o recurso enquanto a versão máxima aceita do SDK estiver disponível. Se quiser fazer upgrade para a próxima versão principal do SDK, remova o recurso descontinuado do seu código ou migre para o substituto dele.

Saiba mais sobre a disponibilidade de versões da API Maps JavaScript, que segue um cronograma trimestral de lançamento e desativação.

Veja orientações sobre como gerenciar dependências de versão com o SDK do Maps para Android, o SDK do Maps para iOS, o SDK do Places para Android e o SDK do Places para iOS.

Descontinuações ativas

Nesta seção, listamos todos os produtos e recursos que estão em período de descontinuação.

Biblioteca do Contexto local da API Maps JavaScript (descontinuada a partir da v3.51.2)

Devido à adoção limitada desse recurso Beta, a Biblioteca do Contexto local foi descontinuada na versão 3.51.2. A Biblioteca do Contexto local vai continuar funcionando até segunda ordem, mas não é recomendável adicioná-la a novos projetos.

Se você quiser criar uma experiência semelhante a essa biblioteca, confira a solução "Descoberta de bairros" no Criador rápido de soluções ou use a biblioteca Places, API Maps JavaScript. Os exemplos de código e codelabs da biblioteca Places podem ser úteis.

Biblioteca de compatibilidade do Places referente ao SDK do Places para Android (a partir de 31 de março de 2022)

Todas as versões da biblioteca de compatibilidade do Places referente ao SDK do Places para Android foram descontinuadas em 31 de março de 2022. Congelamos o desenvolvimento da biblioteca de compatibilidade do Places no SDK do Places para Android versão 2.6.0 (especificado em dependências como com.google.android.libraries.places:places-compat:2.6.0).

Nenhuma nova versão desta biblioteca vai ser lançada após essa data. A única maneira de acessar os recursos e as correções de bugs no SDK do Places para Android versão 2.6.0 e posteriores é usar o SDK do Places para Android.

A biblioteca de compatibilidade do Places foi lançada em janeiro de 2019 para facilitar a migração do SDK legado, disponível no Google Play Services, para o SDK independente do Places para Android.

Siga o guia de migração se quiser usar o SDK do Places para Android. Alguns nomes de métodos, códigos de status e nomes de classes do Autocomplete são diferentes entre a biblioteca de compatibilidade do Places e o SDK do Places para Android. Consulte a documentação Versões para especificar e manter dependências em versões do SDK do Places para Android.

Não há planos de desativar a biblioteca de compatibilidade do Places no momento. No entanto, para continuar usando as versões disponíveis da biblioteca de compatibilidade do Places, considere as limitações de versões antigas do SDK.

Consultas incompatíveis do Place Search na API Places, na biblioteca Places e na API Maps JavaScript (31 de março de 2022 a 31 de março de 2023)

As consultas incompatíveis do Place Search para Text Search, Nearby Search e Find Place nas APIs Places e Maps JavaScript e na biblioteca Places foram descontinuadas em 31 de março de 2022 e vão mostrar mensagens de erro INVALID_REQUEST a partir de 31 de março de 2023.

A API Places, a biblioteca Places e a API Maps JavaScript são compatíveis com três métodos para encontrar lugares: Text Search, Nearby Search e Find Place. Cada método aceita solicitações com combinações aceitas de parâmetros e rejeita a maioria das solicitações com combinações de parâmetros incompatíveis.

Algumas combinações incompatíveis não foram rejeitadas até agora:

  • Solicitações do Text Search com um parâmetro query vazio ou faltando e sem um parâmetro type compatível
  • Solicitações do Text Search com query=*
  • Solicitações do Nearby Search com keyword=*
  • Solicitações do Nearby Search com name=*
  • Solicitações do Find Place com input=*

Essas solicitações incompatíveis do Place Search precisam ser substituídas por uma das seguintes opções:

  • As solicitações do Nearby Search sem o parâmetro keyword (ou name) podem ser usadas para encontrar estabelecimentos nas proximidades. É recomendável também usar o parâmetro type com um tipo compatível. Consulte a Tabela 1: tipos de lugar. Isso oferece a correspondência mais próxima ao comportamento atual das solicitações do Text Search com um parâmetro query vazio ou faltando.

  • As solicitações da API Geocoding com o parâmetro latlng podem ser usadas para encontrar os endereços mais próximos. Isso oferece a correspondência mais próxima ao comportamento atual destas solicitações:

    • Solicitações do Text Search com query=*
    • Solicitações do Nearby Search com keyword=*
    • Solicitações do Nearby Search com name=*
    • Solicitações do Find Place com input=*

Atualização da Política de Segurança de Conteúdo (21 de março de 2022 a maio de 2023)

O suporte a sites que usam a Política de Segurança de Conteúdo (CSP) e não especificam googleapis.com na API Maps JavaScript foi descontinuado na versão 3.49 e não será mais compatível a partir da versão 3.50. A última versão compatível, a 3.49, vai ser desativada no 2º trimestre de 2023. Depois disso, a API Maps JavaScript vai rejeitar todas as solicitações que usam diretivas da CSP e não especificam googleapis.com.

Para evitar a interrupção da experiência no site, especifique googleapis.com na sua CSP. Todas as versões disponíveis da API Maps JavaScript são compatíveis com a CSP.

Serviços relacionados a jogos da Plataforma Google Maps (18 de outubro de 2021 a 31 de dezembro de 2022)

Os serviços relacionados a jogos da Plataforma Google Maps foram descontinuados em 18 de outubro de 2021 e serão desativados em 31 de dezembro de 2022. Durante esse período, o Google continuará oferecendo suporte e corrigindo os principais bugs e interrupções. Consulte o Guia de transição para serviços relacionados a jogos se quiser ver os recursos que ajudam a planejar as próximas etapas dos projetos.

IDs de lugar obsoletos (16 de março de 2021 a 30 de março de 2022)

Em 30 de março de 2022, todas as APIs da Plataforma Google Maps deixarão de aceitar determinados IDs de lugar obsoletos. A partir de 30 de março de 2022, todas as solicitações feitas com IDs de lugar obsoletos serão rejeitadas e retornarão o código de erro INVALID_REQUEST. Para não prejudicar a experiência do usuário, atualize todos os IDs de lugar com mais de 12 meses antes de 30 de março de 2022.

Módulo do Google Maps no google.load (13 de outubro de 2020 a 13 de outubro de 2021)

O serviço que fornece o módulo "Maps" para google.load foi descontinuado em 13 de outubro de 2020 e será desativado em 13 de outubro de 2021. As solicitações seguintes para carregar o módulo "Maps" em google.load resultarão em erro, e nenhum mapa será carregado. Consulte o guia de migração para mais informações.

O SDK do Places para iOS GMSPlaceField agora usa a macro NS_OPTIONS (a partir da versão v4.0.0)

A partir do SDK do Places para iOS v4.0.0, GMSPlaceField usa o NS_OPTIONS em vez de NS_ENUM para melhorar a compatibilidade com o Swift. Leia mais sobre como migrar para GMSPlaceField como NS_OPTIONS.

Para continuar usando GMSPlaceField como NS_ENUM, especifique a v3.10.0 ou anteriores nas dependências.

Métodos do SDK do Places para iOS: setAutocompleteBoundsUsing NorthEastCorner:SouthWestCorner, initWithBounds:filter (v3.10.0 – v4.0.0)

O método auxiliar setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner foi descontinuado a partir da v3.10.0 e não é compatível com a v4.0.0 e mais recentes. Em vez disso, use locationBias ou locationRestriction.

O método initWithBounds:filter foi descontinuado na v3.10.0 e não é compatível com a v4.0.0 e mais recentes. Em vez disso, use initWithFilter: em GMSAutocompleteFetcher.

A versão máxima compatível com esses métodos descontinuados é a v3.10.0.

Para mais detalhes sobre os métodos de substituição, consulte o Apêndice 1.

GMSCoordinateBounds no Place Autocomplete (v3.9.0 – v4.0.0)

Várias propriedades/parâmetros que usam GMSCoordinateBounds no serviço Autocomplete do SDK do Places para iOS foram descontinuados a partir da versão 3.9.0 e não são compatíveis com a versão 4.0.0 e outras mais recentes. A última versão com suporte para as propriedades/parâmetros descontinuados é a v3.10.0.

Limites em GMSAutocompleteViewController

As seguintes propriedades GMSAutocompleteViewController foram descontinuadas:

Para a funcionalidade equivalente, use GMSAutocompleteViewController.autocompleteFilter com GMSAutocompleteFilter.locationBias ou GMSAutocompleteFilter.locationRestriction. A versão mínima do SDK do Places para iOS com as propriedades de substituição é a v3.8.0.

Limites em findAutocompletePredictionsFromQuery e autocompleteQuery

Para a funcionalidade equivalente, use findAutocompletePredictionsFromQuery:filter:sessionToken:callback com GMSAutocompleteFilter.locationBias ou GMSAutocompleteFilter.locationRestriction. A versão mínima do SDK do Places para iOS com as propriedades de substituição é a v3.8.0.

Para mais detalhes sobre os métodos de substituição, consulte o Apêndice 1.

Campo GMSPlace.openNowStatus do Places (v3.0.0 – v4.0.0)

O campo/propriedade GMSPlace.openNowStatus do Places no SDK do Places para iOS foi descontinuado a partir da versão 3.0.0 e não é compatível com a versão 4.0.0 e outras mais recentes. A versão de suporte máxima do campo descontinuado é a v3.10.0.

Em vez disso, use as funções GMSPlace.isOpen ou GMSPlace.isOpenAtDate. A versão mínima do SDK do Places para iOS com essas funções de substituição é a v3.3.0.

Campo do Places: permanently_closed (descontinuado em 26 de maio de 2020)

O campo permanently_closed do Places na API Places e na biblioteca do Places, API Maps JavaScript, foi descontinuado e não deve ser usado. Em vez disso, use business_status (API Places) ou business_status (biblioteca Places, API JavaScript) para saber qual é o status de funcionamento das empresas. A versão mínima da biblioteca Places e da API Maps JavaScript com business_status é a 3.40.

Campos open_now e utc_offset do Places (descontinuados em 20 de novembro de 2019)

Os campos open_now e utc_offset do Places na biblioteca do Places e na API Maps JavaScript, que foram descontinuados em 20 de novembro de 2019, não estão mais disponíveis.

Esses campos foram descontinuados apenas na biblioteca Places e na API Maps JavaScript.

  • O campo open_now foi substituído por PlaceResult.opening_hours.isOpen() no Place Details. Para o Nearby Search e o Text Search, use o parâmetro de solicitação openNow:true para filtrar os lugares que estão abertos no momento. Não é fornecido nenhum equivalente para o Find Place. Para receber esse valor, faça uma solicitação ao Place Details.
  • O campo utc_offset foi substituído por PlaceResult.utc_offset_minutes no Place Details.

Consulte Migração de campos do Places para saber mais.

API Maps JavaScript: google.maps.event.addDomListener() e google.maps.event.addDomListenerOnce() (descontinuados em 7 de abril de 2022)

As funções [google.maps.event.addDomListener()](/maps/documentation/javascript/reference/event#event.addDomListener) e [google.maps.event.addDomListenerOnce()](/maps/documentation/javascript/reference/event#event.addDomListenerOnce) na API Maps JavaScript foram descontinuadas e não podem ser usadas. Em vez disso, utilize o método addEventListener() padrão.

Esses métodos vão continuar funcionando e não há planos de desativação para eles.

Descontinuações concluídas

Nesta seção, listamos todos os produtos e recursos que foram desativados e não estão mais disponíveis.

API Maps JavaScript v2 (19 de maio de 2010 a 26 de maio de 2021)

A versão 2 da API Maps JavaScript não está mais disponível desde 26 de maio de 2021. Como resultado, os mapas da v2 do seu site deixarão de funcionar e vão retornar erros de JavaScript. Para continuar usando mapas no seu site, migre para a API Maps JavaScript v3. Saiba mais sobre como fazer upgrade do aplicativo da API Maps JavaScript da v2 para a v3.

Campos do Places: reference, id, alt_id, scope (3 de setembro de 2019 a 10 de agosto de 2020)

Os campos id, alt_id e scope do Places não estão mais disponíveis desde 10 de agosto de 2020. O campo reference do Places foi descontinuado e não pode ser usado.

  • O campo de resposta id foi substituído pelo campo place_id.
  • O campo de resposta reference foi substituído pela resposta place_id e não pode ser usado.
  • Os campos alt_id e scope não têm equivalente, já que eram usados apenas para o serviço Place Add que foi desativado em julho de 2018.

Consulte Migração de campos do Places para ver mais detalhes.

iOS versão 10, arquitetura ARMv7 de 32 bits no SDK do Maps para iOS 5.0

A partir do SDK do Maps para iOS versão 5.0, o iOS 10 e a arquitetura ARMv7 de 32 bits não são mais compatíveis.

SDK do Places para iOS

Com o lançamento do SDK do Places para iOS 5.0, o GMSCoordinateBounds foi desativado e substituído por GMSPlacesViewportInfo.

Camada de Fusion Tables (experimental) (3 de dezembro de 2018 a 3 de dezembro de 2019)

A camada do Fusion Tables na API Maps JavaScript foi desativada em 3 de dezembro de 2019 e não está mais disponível a partir da versão 3.38. A v3.37 é a última versão com suporte a esse recurso. Saiba mais.

SDKs do Places para Android e iOS (29 de janeiro de 2019 a 29 de julho de 2019)

Em 29 de janeiro de 2019, os SDKs do Places para Android e iOS que foram atualizados substituíram as versões existentes. As versões atuais do SDK do Places para iOS e Android e do Place Picker foram descontinuadas em 29 de janeiro de 2019 e desativadas em 29 de julho de 2019.

Place Add e Place Delete (30 de junho de 2017 a 30 de junho de 2018)

Desde 30 de junho de 2018, os recursos Place Add e Place Delete foram desativados e não estão mais disponíveis.

Apêndice 1: resumo das substituições de API descontinuadas do SDK do Places para iOS

Na tabela a seguir, mostramos o que precisa ser usado em cada método ou propriedade descontinuados.

Método/propriedade obsoletos Passe a usar
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(em GMSAutocompleteViewController)		 locationRestriction e locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(em GMSAutocompleteResultsViewController)		 locationRestriction e locationBias
setAutocompleteBoundsUsingNorthEastCorner:SouthWestCorner
(em GMSAutocompleteTableDataSource)		 locationRestriction e locationBias
initWithBounds:filter
(em GMSAutocompleteFetcher)		 initWithFilter:
autocompleteBounds e autocompleteBoundsMode
(em GMSAutocompleteViewController)		 GMSAutocompleteViewController.autocompleteFilter com locationBias ou locationRestriction
findAutocompletePredictionsFromQuery:bounds:boundsMode:filter:SessionToken:callback, autocompleteQuery:bounds:filter:callback e autocompleteQuery:bounds:boundsMode:filter:callback
(em GMSPlacesClient)		 findAutocompletePredictionsFromQuery:filter:sessionToken:callback com locationBias ou locationRestriction.

A versão mínima do SDK do Places para iOS com as propriedades de substituição é a v3.8.0.