A API Places (nova) inclui as seguintes APIs:
- Detalhes do lugar (novo)
- Place Photo (novo)
- Pesquisa por proximidade (novo)
- Pesquisa de texto (nova)
- Preenchimento automático (novo)
Este documento contém uma visão geral dessas novas APIs.
Place Details (New)
Um ID de lugar identifica de forma exclusiva um lugar 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 de Place Details (New). Uma solicitação de Place Details (New) retorna informações abrangentes sobre o local indicado, como o endereço completo, o número de telefone, a classificação do usuário e as avaliações.
Há muitas maneiras de conseguir um ID de local. Você pode usar:
- Pesquisa de texto (nova)
- Pesquisa por proximidade (novo)
- API Geocoding
- API Routes
- API Address Validation
- Place Autocomplete
Place Photo (novo)
A API Place Photo (New) permite adicionar conteúdo fotográfico de alta qualidade ao seu aplicativo, acesso a milhões de fotos armazenadas no banco de dados do Google Places. Usando a API Place Photo (New), é possível acessar as fotos e redimensionar a imagem para o tamanho ideal para o aplicativo.
Todas as solicitações para a API Place Photo (nova) precisam incluir um nome de recurso de foto, que identifica de forma exclusiva a foto a ser retornada. Para saber o nome do recurso de foto, use:
Para incluir o nome do recurso de foto na resposta de uma solicitação de 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 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".
Você pode refinar a pesquisa especificando detalhes como faixas de preço, status de abertura atual, classificações ou tipos de lugar específicos. Também é possível especificar para dar preferência a resultados de um local específico ou restringir a pesquisa a um local específico.
Pesquisa por proximidade (novo)
Permite especificar uma região para pesquisar 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 lugar. Por exemplo, especifique "
pizza_restaurant" e "shopping_mall" para procurar um restaurante de pizza localizado em um shopping na região especificada.
A principal diferença entre as duas pesquisas é que a pesquisa de texto (nova) permite especificar uma string de pesquisa arbitrária, enquanto a pesquisa por proximidade (nova) exige uma área específica para pesquisar.
Autocomplete (novo) e tokens de sessão
O Place Autocomplete (novo) é um serviço da Web que retorna previsões de locais 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 chamadas de preenchimento automático (novo) como sessões. O preenchimento automático (novo) 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 funcionamento do 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 local. As opções incluem:
|
subDestinations |
Locais ú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:
|
evChargeOptions |
Número de carregadores de veículos elétricos (VEs) nesse eletroposto. Embora alguns carregadores de VE tenham vários conectores, cada carregador pode carregar apenas um veículo por vez. Por isso, esse campo reflete o número de carregadores de VE disponíveis em um determinado momento. |
shortFormattedAddress |
Um endereço curto e legível para 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 conferir uma lista completa de
valores possíveis, consulte Tipos aceitos. |
primaryTypeDisplayName |
O nome de exibição do tipo principal, localizado para o idioma da solicitação, se aplicável. Para conferir uma lista completa de valores possíveis, consulte Tipos aceitos. |
Atributos
A API Places (nova) inclui vários novos atributos:
| Atributo | Descrição |
|---|---|
outdoorSeating |
O lugar tem mesas ao ar livre. |
liveMusic |
O lugar tem 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 cães. |
restroom |
O lugar tem um banheiro. |
goodForGroups |
O local 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 lugar oferece estacionamento com acessibilidade para cadeirantes. |
wheelchairAccessibleEntrance |
O lugar tem uma entrada acessível a cadeirantes. |
wheelchairAccessibleRestroom |
O lugar tem um banheiro acessível a pessoas em cadeira de rodas. |
wheelchairAccessibleSeating |
O lugar tem assentos acessíveis a cadeirantes. |
Migrar para as novas APIs Places
Se você já é cliente da API Places e quer migrar seu app para usar as novas APIs, consulte a documentação de migração a seguir: