Nesta página, listamos todos os produtos e recursos da Plataforma Google Maps que estão em um período de suspensão de uso. Isso inclui produtos no Maps, Routes e Places.
Como a suspensão de uso funciona
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 da versão 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.
Suspensões de uso ativas
Nesta seção, listamos todos os produtos e recursos que estão em período de descontinuação.
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 receber 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 compatíveis 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âmetrotype
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
(ouname
) podem ser usadas para encontrar estabelecimentos nas proximidades. É recomendável também usar o parâmetrotype
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âmetroquery
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=*
- Solicitações do Text Search com
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 a partir da versão 3.49 e não vai mais ser 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 versão v4.0.0, GMSPlaceField
usa oNS_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 v3.9.0 e não são compatíveis com av4.0.0 e mais recentes. A última versão com suporte para os parâmetros/propriedades descontinuados é a v3.10.0.
Limites em GMSAutocompleteViewController
As seguintes propriedades GMSAutocompleteViewController
foram suspensas:
GMSAutocompleteViewController.autocompleteBounds
GMSAutocompleteViewController.autocompleteBoundsMode
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
- Parâmetros
bounds
eboundsMode
para:
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 v3.0.0 e não é compatível com a versão 4.0.0 e superiores.
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 ver o status de funcionamento das empresas. A versão mínima da biblioteca Places e da API Maps JavaScript com business_status
é a v3.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, que foram descontinuados em 20 de novembro de 2019, não estão mais disponíveis.
Esses campos foram descontinuados apenas na biblioteca do Places e na API Maps JavaScript.
- O campo
open_now
foi substituído porPlaceResult.opening_hours.isOpen()
no Place Details. Para o Nearby Search e o Text Search, use o parâmetro de solicitaçãoopenNow: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 porPlaceResult.utc_offset_minutes
na Place Details.
Consulte Migração de campos do Places para saber mais.
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 retornarão 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 uso do campo reference
do Places foi descontinuado. Não é recomendado usá-lo.
- O campo de resposta
id
foi substituído pelo campoplace_id
. - O campo de resposta
reference
foi substituído pela respostaplace_id
e não pode ser usado. - Os campos
alt_id
escope
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 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.
- Atualize para a versão mais recente do SDK do Places para iOS.
- Atualize para a versão mais recente do SDK do Places para Android.
- O Place Picker não está mais disponível desde 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 obsoletas do SDK do Places para iOS
Na tabela a seguir, mostramos o método de substituição a ser usado em cada método ou propriedade obsoletos.
A versão mínima do SDK do Places para iOS com as propriedades de substituição é a v3.8.0.