Introdução
A API Places (nova) inclui as seguintes APIs:
Este documento contém uma visão geral dessas novas APIs.
Place Details (novo)
Um ID de lugar identifica de forma exclusiva um local no banco de dados do Google Places e no Google Maps. Com um ID de lugar, você pode solicitar detalhes sobre um determinado estabelecimento ou ponto de interesse iniciando uma solicitação do Place Details (New). Uma solicitação do Place Details (New) retorna informações abrangentes sobre o lugar indicado, como endereço completo, número de telefone, classificação e avaliações de usuários.
Há muitas maneiras de conseguir um ID de lugar. Você pode usar:
- Text Search (novo)
- Nearby Search (novo)
- API Geocoding
- API Routes
- API Address Validation
- Autocomplete (New)
Place Photos (novo)
Com o Place Photos (novo), você pode adicionar fotos de alta qualidade ao seu aplicativo acessando milhões de imagens armazenadas no banco de dados do Google Places. Usando a API Place Photos (New), é possível acessar as fotos e redimensionar a imagem de acordo com o tamanho ideal para o aplicativo.
Todas as solicitações para a API Place Photos (nova) precisam incluir um nome de recurso de foto, que identifica exclusivamente a foto a ser retornada. Para conseguir o nome do recurso da foto, use:
Para incluir o nome do recurso de foto na resposta de uma solicitação do Place Details (novo), Text Search (novo) ou Nearby Search (novo), inclua o campo photos na máscara de campo da solicitação.
Text Search (novo) e Nearby Search (novo)
A API Places (nova) inclui duas APIs de pesquisa:
-
Permite especificar uma string de texto para pesquisar um lugar. Por exemplo: "Comida vegetariana apimentada em Sydney, Austrália" ou "Restaurante de frutos do mar perto de Palo Alto, CA".
É possível refinar a pesquisa especificando detalhes como níveis de preço, status de funcionamento atual, classificações ou tipos de lugar específicos. Também é possível especificar para priorizar os resultados de um local específico ou restringir a pesquisa a um local específico.
-
Permite especificar uma região para pesquisar junto com uma lista de tipos de lugar. Especifique a região como um círculo definido pelas coordenadas de latitude e longitude do ponto central e do raio em metros.
Especifique um ou mais tipos de lugar que definem as características do local. Por exemplo, especifique "
pizza_restaurant" e "shopping_mall" para pesquisar uma pizzaria localizada em um shopping center na região especificada.
A principal diferença entre as duas pesquisas é que a Text Search (nova) permite especificar uma string de pesquisa arbitrária, enquanto a Nearby Search (nova) exige uma área específica para a pesquisa.
Autocomplete (novo) e tokens de sessão
O Autocomplete (novo) é um serviço da Web que retorna previsões de lugares e de consultas em resposta a uma solicitação HTTP. Na solicitação, especifique uma string de pesquisa de texto e limites geográficos que controlam a área de pesquisa.
Os tokens de sessão são strings geradas pelo usuário que rastreiam as chamadas do Autocomplete (novo) como sessões. O Autocomplete (New) usa tokens de sessão para agrupar as fases de consulta e seleção de uma pesquisa de preenchimento automático do usuário em uma sessão discreta para fins de faturamento.
Novos campos, atributos e opções de acessibilidade
A API Places (nova) inclui novos campos, atributos e opções de acessibilidade para fornecer aos usuários mais informações sobre um lugar. Esses aspectos são descritos nas seções a seguir.
Campos
A API Places (nova) inclui vários campos novos:
| Campo | Descrição |
|---|---|
regularSecondaryOpeningHours |
Descreve horários específicos para determinadas operações. O horário de funcionamento secundário é diferente do horário principal de uma empresa. Por exemplo, um restaurante pode especificar o horário de drive-thru ou de entrega como horário secundário. |
paymentOptions |
Opções de pagamento aceitas pelo lugar. Um lugar pode aceitar mais de uma opção de pagamento. Se os dados da opção de pagamento não estiverem disponíveis, o
campo da opção de pagamento não será definido. As opções incluem:
|
parkingOptions |
Opções de estacionamento oferecidas pelo lugar. As opções incluem:
|
subDestinations |
Lugares únicos relacionados a um lugar específico. Por exemplo, os terminais de aeroporto são considerados subdestinos de um aeroporto. |
fuelOptions |
As informações mais recentes sobre as opções de combustível disponíveis em um posto de gasolina. Essas informações são atualizadas regularmente. As opções incluem
o seguinte:
|
evChargeOptions |
Número de carregadores de veículos elétricos (VE) neste eletroposto. Embora alguns carregadores de VE tenham vários conectores, cada carregador só pode carregar um veículo por vez. Como resultado, esse campo reflete o número de carregadores de VE disponíveis em um determinado momento. |
shortFormattedAddress |
Um endereço curto e legível por humanos de um lugar. |
primaryType |
O tipo principal do resultado fornecido. Por exemplo, um lugar pode
ser classificado como cafe ou airport. Um
lugar só pode ter um tipo principal. Para ver a lista completa de
valores possíveis, consulte Tipos compatíveis. |
primaryTypeDisplayName |
O nome de exibição do tipo principal, localizado para o idioma da solicitação, se aplicável. Para ver a lista completa de valores possíveis, consulte Tipos compatíveis. |
entrances |
Entradas para o destino. Uma entrada é um único par de coordenadas de latitude/longitude que define o local de um ponto de entrada e saída de um lugar. |
navigationPoints |
Pontos de navegação para o destino. Um ponto de navegação é um local próximo a uma via onde a navegação pode terminar, incluindo os meios de transporte e usos aceitos. |
Atributos
A API Places (nova) inclui vários atributos novos:
| Atributo | Descrição |
|---|---|
outdoorSeating |
O lugar tem mesas externas. |
liveMusic |
O lugar oferece música ao vivo. |
menuForChildren |
O lugar tem um cardápio infantil. |
servesCocktails |
O lugar serve coquetéis. |
servesDessert |
O lugar serve sobremesa. |
servesCoffee |
O lugar serve café. |
goodForChildren |
O lugar é bom para crianças. |
allowsDogs |
O lugar permite a entrada de cães. |
restroom |
O lugar tem banheiro. |
goodForGroups |
O lugar acomoda grupos. |
goodForWatchingSports |
O lugar é adequado para assistir esportes. |
Opções de acessibilidade
A API Places (nova) inclui os seguintes campos de opção de acessibilidade:
| Campo | Descrição |
|---|---|
wheelchairAccessibleParking |
O local oferece estacionamento acessível a pessoas em cadeira de rodas. |
wheelchairAccessibleEntrance |
O local tem uma entrada acessível a pessoas em cadeira de rodas. |
wheelchairAccessibleRestroom |
O local tem um banheiro acessível a pessoas em cadeira de rodas. |
wheelchairAccessibleSeating |
O local tem assentos com acessibilidade para pessoas em cadeira de rodas. |
Resumos gerados com IA
Os resumos gerados com IA da API Places (nova) usam os recursos do modelo do Gemini para retornar resumos sobre lugares e áreas que podem ajudar os usuários a decidir aonde ir.
Os resumos gerados com IA sintetizam dados de várias fontes para ajudar os usuários a tomar decisões mais informadas sobre um lugar. Por exemplo, se você estiver pensando em ir a um restaurante novo, um resumo gerado com IA pode mostrar os destaques do cardápio, dar uma ideia do clima do lugar ou reunir temas das avaliações dos usuários. Se você estiver visitando uma nova cidade, um resumo com tecnologia de IA pode fornecer uma visão geral das atrações e comodidades próximas.
Recursos com tecnologia de IA adicionados à API Places (nova)
Os resumos gerados com IA estão disponíveis em Place Details (novo), Text Search (novo) e Nearby Search (novo). Os seguintes resumos gerados com IA estão disponíveis nas respostas da API Places (nova):
- Resumos de lugares, que são resumos curtos relacionados a um lugar específico.
- Resumos das avaliações, que são resumos fáceis de entender do que os avaliadores disseram sobre um lugar.
- Resumos de área, que fornecem visões gerais de lugares próximos e conhecidos na área ao redor. Isso inclui resumos de bairros e de eletropostos.
O Google gera esses resumos com frequência para garantir que eles sejam atualizados com base nas informações mais recentes disponíveis. Ao fazer uma solicitação da API Places (nova), você mostra os dados mais recentes no seu app.
Migrar para a API Places (nova)
Se você já é cliente da API Places (legada) e quer migrar seu app para usar a API Places (nova), consulte a seguinte documentação de migração:
- Migrar para Place Details (New)
- Migrar para o Nearby Search (novo)
- Migrar para a Text Search (New)
- Migrar para o Place Photos (novo)
- Migrar para o Autocomplete (novo)