A nova API Places inclui as seguintes APIs:
- Place Details
- Place Photo (em inglês)
- Nearby Search (link em inglês)
- Text Search (em inglês)
- Preenchimento automático
Este documento contém uma visão geral dessas novas APIs.
API Place Details
Um ID de lugar identifica um lugar de forma exclusiva no banco de dados do Google Places e no Maps. Com um ID de lugar, você pode solicitar detalhes sobre um estabelecimento ou ponto de interesse específico iniciando uma solicitação Place Details (novo). 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 de usuários e avaliações.
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
- Place Autocomplete
API Place Photo
A API Place Photo (New) permite adicionar conteúdo fotográfico de alta qualidade ao aplicativo oferecendo acesso a milhões de fotos armazenadas no banco de dados do Google Places. Com a API Place Photo (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 Photo (New) precisam incluir um nome de recurso de foto, que identifique exclusivamente 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 do Place Details (New), Text Search (New) ou Nearby Search (New), inclua o campo photos
na máscara de campo da solicitação.
Text Search e Nearby Search
A API Places inclui duas APIs de pesquisa:
-
Permite especificar uma string de texto para pesquisar um local. Por exemplo: "Comida vegetariana picante em Sydney, Austrália" ou "Restaurantes finos de frutos do mar perto de Palo Alto, CA".
Você pode refinar a pesquisa especificando detalhes como níveis de preço, status de abertura atual, classificações ou tipos de lugar específicos. Também é possível especificar a polarização dos resultados para um local específico ou restringir a pesquisa a um local específico.
-
Permite especificar uma região para pesquisar, além de 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 pesquisar uma pizzaria localizada em um shopping na região especificada.
A principal diferença entre as duas pesquisas é que o Text Search (novo) permite especificar uma string de pesquisa arbitrária, enquanto o Nearby Search (novo) exige uma área específica para pesquisar.
API Autocomplete e tokens de sessão
A API Autocomplete (nova) é um serviço da Web que retorna previsões de lugares e consultas em resposta a uma solicitação HTTP. Na solicitação, especifique uma string de pesquisa de texto e limites geográficos que controlem a área de pesquisa.
Os tokens de sessão são strings geradas pelo usuário que rastreiam chamadas de preenchimento automático (novas) como sessões. O Autocomplete (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 os horários de funcionamento de drive-thru ou de entrega como horários secundários. |
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 exclusivos que estão relacionados a um determinado lugar. Por exemplo, os terminais de aeroportos 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 (VE) nesta estação. Embora alguns carregadores de VE tenham vários conectores, cada um deles 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 de um local. |
primaryType |
O tipo principal do resultado fornecido. Por exemplo, um lugar pode ser classificado como cafe ou airport . Um local só pode ter um tipo principal. Para ver a lista completa dos 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 dos valores possíveis, consulte Tipos compatíveis. |
Atributos
A API Places (nova) inclui vários atributos novos:
Atributo | Descrição |
---|---|
outdoorSeating |
O lugar oferece mesas ao ar livre. |
liveMusic |
O local oferece música ao vivo. |
menuForChildren |
O lugar tem um menu infantil. |
servesCocktails |
O local serve coquetéis. |
servesDessert |
O lugar serve sobremesa. |
servesCoffee |
O lugar serve café. |
goodForChildren |
O lugar é bom para crianças. |
allowsDogs |
O lugar aceita cães. |
restroom |
O lugar tem um banheiro. |
goodForGroups |
O lugar acomoda grupos. |
goodForWatchingSports |
O local é adequado para assistir a esportes. |
Opções de acessibilidade
A API Places (nova) inclui os seguintes campos de opções de acessibilidade:
Campo | Descrição |
---|---|
wheelchairAccessibleParking |
O lugar 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 lugar tem assento acessível a pessoas em cadeira de rodas. |
Migre para as novas APIs Places
Se você já é cliente da API Places e quer migrar seu app para usar as novas APIs, consulte a seguinte documentação de migração: