Suspensões de uso

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.


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.


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:

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 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 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 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 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 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.


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.

Método/propriedade obsoletos Use em vez disso
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.