Atualizações de produtos
Fizemos atualizações em várias das nossas APIs. Veja mais informações abaixo.
Maps | Routes | Places | Cota | Alterações de nomes de produtos e marcas
Maps
Não há alterações de produtos para o Maps. Consulte Alterações de faturamento específicas de APIs.
Routes
Não há alterações de produtos para o Routes. Consulte Alterações de faturamento específicas de APIs.
Places
Places Details
As solicitações de Places Details podem ser restringidas a campos específicos.
As solicitações de Places Details (em inglês) foram atualizadas para retornar apenas os campos que você especificar. Antes, as solicitações de Places Details retornavam todos os dados disponíveis associados ao lugar especificado. Com essa mudança, a resposta fica limitada apenas aos campos especificados por meio do parâmetro fields
. Os campos correspondem aos resultados de Places Details (em inglês) e são divididos em três categorias de faturamento: "Basic", "Contact" e "Atmosphere". O custo de cada solicitação varia de acordo com os campos selecionados. No entanto, se nenhum campo for definido, todos os dados disponíveis para o local especificado serão retornados e será cobrado o valor máximo.
Todas as cobranças de solicitações de Places Details usarão a taxa básica.
A categoria Basic (em inglês) não gera custos extras e inclui os seguintes campos:
address_component
, adr_address
, formatted_address
, geometry
, icon
, name
, permanently_closed
, photo
, place_id
, plus_code
, type
, url
, utc_offset
, vicinity
A categoria Contact (em inglês) gera custos extras e inclui os seguintes campos:
formatted_phone_number
, international_phone_number
, opening_hours
, website
A categoria Atmosphere (em inglês) gera custos extras e inclui os seguintes campos:
price_level
, rating
, review
Observação: as atribuições (html_attributions
) são sempre retornadas com todas as chamadas, independentemente de terem sido ou não solicitadas.
O que você pode fazer:
- Verificar nos seus aplicativos quais dados de Places Details você está usando.
- Atualizar seu código para adicionar o parâmetro
fields
. - Fazer login no Console do Google Cloud Platform para entender o uso atual da API Places. Se precisar de ajuda com o console, acesse a Central de Ajuda da Conta do Google.
Exemplos
É possível usar o parâmetro fields
para especificar os campos a serem retornados para uma solicitação de Place Details, conforme mostrado no exemplo a seguir: (os campos name
, rating
e formatted_phone_number
estão especificados):
Serviço da Web
https://maps.googleapis.com/maps/api/place/details/json?placeid={PLACE_ID}&fields=name,rating,formatted_phone_number&key=YOUR_API_KEY
JavaScript
const placeId = 'not_actually_a_place_id'; const request = { placeId: placeId, fields: ['name', 'rating', 'formatted_phone_number'] }; const service = new google.maps.places.PlacesService(map); service.getDetails(request, callback);
Find Place
Serviços da Web
Foi introduzido um novo serviço de Find Place (em inglês) para os serviços da Web, que usa uma entrada de texto ou número de telefone e retorna um lugar. A entrada de texto pode ser qualquer tipo de dados do Google Places, por exemplo: um nome, um endereço ou um número de telefone. É preciso usar o parâmetro fields
com o Find Place para receber os campos necessários. Os campos das categorias "Basic", "Contact" ou "Atmosphere" são cobrados da mesma maneira que uma solicitação do Places Details (em inglês). Se nenhum campo for especificado, o PlaceId do local encontrado será retornado e você não será cobrado.
O que você pode fazer:
Pense na possibilidade de migrar suas solicitações atuais de Place Search (em inglês) para o Find Place.
JavaScript
Foram introduzidas duas novas APIs Find Place para JavaScript. O serviço Find Place From Query usa uma consulta de texto e retorna um lugar. A consulta pode ser qualquer tipo de dados do Places, por exemplo, um nome ou endereço. O serviço Find Place From Phone Number (em inglês) usa um número de telefone como entrada e retorna um lugar. É preciso usar o parâmetro fields
com ambas as APIs Find Place para receber os campos necessários. Os campos das categorias "Basic", "Contact" ou "Atmosphere" são cobrados da mesma maneira que uma solicitação do Places Details (em inglês). O parâmetro fields
é obrigatório. Se nenhum campo for especificado, a solicitação resultará em um erro.
O que você pode fazer
Pense na possibilidade de migrar suas solicitações atuais de Text Search (em inglês) para o Find Place.
Exemplos
Os exemplos a seguir exibem uma solicitação de Web Service Find Place da API Places para "Museu de Arte Contemporânea da Austrália", incluindo os campos photos
, formatted_address
, name
, rating
, opening_hours
e geometry
.
Serviço da Web
https://maps.googleapis.com/maps/api/place/findplacefromtext/json?input=Museum%20of%20Contemporary%20Art%20Australia&inputtype=textquery&fields=photos,formatted_address,name,rating,opening_hours,geometry&key=YOUR_API_KEY
JavaScript
var map; var service; var infowindow; function initMap() { var circularquay = new google.maps.LatLng(-33.8617374,151.2021291); map = new google.maps.Map(document.getElementById('map'), { center: circularquay, zoom: 15 }); var request = { query: 'Museum of Contemporary Art Australia', fields: ["photos", "formatted_address", "name", "rating", "opening_hours", "geometry"], }; service = new google.maps.places.PlacesService(map); service.findPlaceFromQuery(request, callback); } function callback(results, status) { if (status == google.maps.places.PlacesServiceStatus.OK) { for (var i = 0; i < results.length; i++) { var place = results[i]; createMarker(results[i]); } } }
SDKs para dispositivos móveis para o Places
O Google está preparando novas versões do SDK do Places para Android e do SDK do Places para iOS (links em inglês). Esta seção descreve as alterações e como elas afetarão você.
- Um novo SDK do Places para Android será disponibilizado como uma biblioteca independente e não estará mais disponível por meio dos serviços do Google Play. Esta versão não será compatível com versões anteriores do SDK atual.
- Um novo SDK do Places para iOS será disponibilizado.
Vários recursos do SDK do Places serão atualizados para refletir as alterações gerais da API Places, afetando as duas plataformas para dispositivos móveis:
- A solicitação do Places Details (Android e iOS, links em inglês) terá um novo parâmetro
fields
. - A cobrança de Autocomplete será feita com base em sessões.
Nos próximos meses, compartilharemos mais detalhes, incluindo um cronograma e o prazo para migração para as novas versões do SDK. Essas novas versões substituirão as versões atuais do SDK. Os SDKs atuais se tornarão obsoletos e seguirão o cronograma apropriado para suspensão de uso.
API Maps Elevation
Com o lançamento da Plataforma Google Maps, novos clientes precisarão entrar em contato com o Suporte para acessar a API Maps Elevation. Os usuários que não têm uma chave e usam essa API precisarão se inscrever para obter uma conta do Google Cloud e ativar a API Maps Elevation o quanto antes.
Cota
Novos limites de consultas por segundo (QPS) e de uso
Não haverá mais limites de cota diários (QPD, na sigla em inglês), mas sim novos limites mais altos de consultas por segundo (QPS) para a maioria dos nossos serviços. Todos os clientes de autosserviço atuais serão automaticamente transferidos para os novos limites de QPS.
API | Limites atuais de uso padrão | Novos limites de uso padrão | |
---|---|---|---|
Directions |
100 mil QPD, 50 QPS |
50 QPS |
|
Distance Matrix |
100 mil EPD, 100 EPS |
1.000 EPS |
|
Elevation |
100 mil QPD, 50 QPS |
100 QPS |
|
Geocoding |
100 mil QPD, 50 QPS |
50 QPS |
|
Geolocation |
100 mil QPD, 50 QPS |
100 QPS |
|
Dynamic Maps |
100 mil QPD |
500 QPS |
|
Static Maps |
100 mil QPD |
500 QPS |
|
Street View Image |
100 mil QPD |
500 QPS |
|
Time Zone |
100 mil QPD, 50 QPS |
500 QPS |
|
Places (JavaScript e Web) |
150 mil QPD |
100 QPS |
|
Roads |
100 mil QPD |
500 QPS |
*EPS = elementos por segundo, EPD = elementos por dia, QPS = consultas por segundo, QPD = consultas por dia
Se você estiver limitando suas solicitações com limites de cota diária da API padrão anterior, poderá manter o mesmo comportamento adicionando um limite diário de cota ao seu projeto no Console do Google Cloud Platform. Saiba mais.
Alterações de nomes de produtos e marcas
- Quais serão as mudanças nos nomes de produtos e marcas?
-
Primeiro, mudamos nossa marca para "Plataforma Google Maps", que inclui as mesmas APIs que você já conhece, mas com faturamento simplificado e um caminho de escalonamento mais fácil que acompanha seu crescimento. Além disso, passamos a oferecer soluções abrangentes voltadas aos setores de jogos, serviços de transporte por aplicativo e rastreamento de ativos. Continuaremos concedendo o acesso à ampla cobertura global de infraestrutura do Google Maps, que atende a mais de um bilhão de usuários em mais de 200 países e territórios.
Segundo, com a Plataforma Google Maps, nossas APIs foram simplificadas em três produtos principais: Maps, Routes e Places. Cada produto principal inclui vários recursos e é ativado por diferentes APIs. Para visualizar recursos e APIs por produto, acesse a página de documentação (em inglês).
Terceiro, simplificamos os nomes das nossas APIs e SKUs de faturamento para facilitar a localização e o uso. Veja a seguir uma lista dos novos nomes. Para ver detalhes sobre como as novas SKUs são acionadas, consulte o guia para entender o faturamento.
Alterações de nomes das APIs
Nome antigo Novo nome API Google Maps Android
SDK do Maps para Android
API Google Maps Directions
API Directions
API Google Maps Distance Matrix
API Distance Matrix
API Google Maps Geocoding
API Geocoding
API Google Maps Geolocation
API Geolocation
API Google Maps JavaScript
API Maps JavaScript
API Google Maps Roads
API Roads
SDK do Google Maps para iOS
SDK do Maps para iOS
API Google Maps Time Zone
API Time Zone
API Google Places para Android
SDK do Places para Android
API Google Places para iOS
SDK do Places para iOS
Serviço da Web da API Google Places
API Places
API Google Static Maps
API Maps Static
API Google Street View Image
API Street View
Biblioteca do Places na API Maps JavaScript
Biblioteca do Places, API Maps JavaScript
Alterações de nomes das SKUs de faturamento
Produto SKU de faturamento: novo nome Descrição Maps
Static Maps
Exibe mapas estáticos. Defina um estilo para eles com marcadores, linhas, cores, polígonos e imagens.
Dynamic Maps
Exibe mapas interativos. Aplique zoom, faça o gesto de pinça, gire e incline os mapas para explorar com mais detalhes e defina um estilo.
Static Street View
Exibe uma imagem estática do Street View, uma imagem panorâmica de 360 graus ou uma imagem em miniatura.
Dynamic Street View
Exibe uma imagem interativa do Street View, uma imagem panorâmica de 360 graus ou uma imagem em miniatura.
Routes
Directions
Fornece rotas para carro, transporte público, bicicleta, a pé e cria rotas com até 10 pontos de referência.
Directions Advanced
Fornece rotas multimodais, cria rotas com até 25 pontos de referência e dá acesso a informações de trânsito em tempo real.
Distance Matrix
Fornece tempos de deslocamento e distância para um ou mais locais.
Distance Matrix Advanced
Fornece tempos de deslocamento e distância para um ou mais locais, usando informações de trânsito em tempo real.
Roads - Route Traveled
Cria itinerários determinando a rota percorrida, coletando até 100 pontos de GPS ao longo de uma rota.
Roads - Nearest Road
Determina as vias mais próximas usando até 100 coordenadas independentes.
Places
Basic Data
Fornece nomes e endereços para mais de 100 milhões de lugares e pontos de interesse.
Contact Data
Fornece nomes, endereços e informações de contato para mais de 100 milhões de lugares e pontos de interesse.
Atmosphere Data
Fornece nomes, endereços, informações de contato e detalhes valiosos, como avaliações e ambiente, para mais de 100 milhões de lugares e pontos de interesse.
Places Photo
Adiciona uma foto de alta qualidade a lugares e pontos de interesse com acesso a milhões de fotos.
Places - Text Search
Retorna uma lista de lugares por perto com base em uma string de pesquisa (por exemplo, "restaurante de sushi").
Places - Nearby Search
Retorna uma lista de lugares por perto com base na localização de um usuário.
Find Place
Transforma um número de telefone, um endereço ou um nome em um local e fornece o nome e endereço dele.
Autocomplete with Details
Preenche automaticamente as sugestões de lugares com o Places Details.
Autocomplete - por solicitação
Preenche automaticamente as sugestões de lugares quando o usuário insere um endereço ou um nome de lugar. O faturamento é feito de acordo com os caracteres digitados.
Autocomplete - por sessão
Preenche automaticamente as sugestões de lugares quando o usuário insere um endereço ou um nome de lugar. Faturamento por sessão.
Geolocation
Retorna o lugar e o raio de precisão de um dispositivo usando Wi-Fi ou torres de celular como base.
Geocoding
Converte endereços em coordenadas geográficas e vice-versa.
Time Zone
Retorna um fuso horário de qualquer lugar, com base nas coordenadas geográficas e na data.
Para ativar APIs ou configurar o faturamento, faça o seguinte:
- Escolha um ou mais produtos abaixo
- Selecione um projeto
- Configure seu faturamento