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 serão desativados e não estarão mais disponíveis.
Descontinuação nas versões do SDK
Nos SDKs e na API Maps JavaScript, as suspensões de uso de recursos estão associadas à disponibilidade das versões. As novas versões principais incluem alterações interruptivas, como a suspensão de uso de recursos, e as notas da versão indicam a versão máxima aceita de cada recurso suspenso. Você pode continuar 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 suspenso 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 atualmente em um período de descontinuação.
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 subsequentes 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.
A biblioteca do Places, API Maps JavaScript GMSPlaceField agora usa a macro NS_OPTIONS (a partir da v4.0).
A partir da biblioteca do Places, API Maps JavaScript v4.0.0, GMSPlaceField agora usa a macro NS_OPTIONS em vez deNS_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 superiores.
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 superiores.
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 utilizam GMSCoordinateBounds na biblioteca do Places, serviço JavaScript API Autocomplete, foram descontinuados a partir da v3.9.0, e não são compatíveis com a v4.0.0 e superiores. A versão máxima de suporte para os parâmetros/propriedades descontinuados é a v3.10.0.
Limites em GMSAutocompleteViewController
As seguintes propriedades GMSAutocompleteViewController foram suspensas:
GMSAutocompleteViewController.autocompleteBoundsGMSAutocompleteViewController.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
boundseboundsModepara:
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 do Places, API JavaScript) para ver o status operacional de empresas. A versão mínima da biblioteca do 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_nowfoi substituído porPlaceResult.opening_hours.isOpen()no Place Details. Para o Nearby Search e o Text Search, use o parâmetro de solicitaçãoopenNow:truepara 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_offsetfoi substituído porPlaceResult.utc_offset_minutesna 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
idfoi substituído pelo campoplace_id. - O campo de resposta
referencefoi substituído pela respostaplace_ide não pode ser usado. - Os campos
alt_idescopenã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.
API Maps JavaScript v2 (19 de maio de 2010 a 26 de maio de 2021)
A versão 2 da API Maps JavaScript foi descontinuada em 19 de maio de 2010 e será desativada em 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 evitar qualquer inconveniente, recomendamos migrar seu site para a API Maps JavaScript v3 antes de 26 de maio de 2021. Saiba mais sobre como fazer upgrade do aplicativo da API Maps JavaScript da v2 para a v3.
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.
Campos do Places: reference, id, alt_id, scope (3 de setembro de 2019 a 10 de agosto de 2020)
Os campos reference, id, alt_id e scope do Places foram descontinuados em 3 de setembro de 2019 e serão desativados em 3 de junho de 2020.
- Os campos de resposta
idereferenceforam substituídos pelo campoplace_id. - Os campos
alt_idescopenã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.
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 suspensas 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.