Sobre a API Places (nova)

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 local identifica exclusivamente 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 um Place Details (novo) solicitação. Uma solicitação de Place Details (novo) retorna informações abrangentes sobre o local indicado, tal como seu endereço completo, número de telefone, avaliação do usuário e avaliações.

Há muitas maneiras de se obter um ID de lugar. Você pode usar:

Place Photo (novo)

A API Place Photo (novo) permite adicionar conteúdo fotográfico de alta qualidade ao aplicativo, concedendo a você acesso a milhões de fotos armazenadas no no banco de dados do Google Places. Com a API Place Photo (novo), você pode acessar a fotos e redimensionar a imagem para o tamanho ideal para seu aplicativo.

Todas as solicitações para a API Place Photo (nova) precisam incluir um nome de recurso de foto, que identifica exclusivamente a foto a ser retornada. Você pode acessar o recurso de foto usando:

Para incluir o nome do recurso de foto na resposta de um Place Details (novo), de texto (novo) ou de 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:

  • Text Search (novo)

    Permite especificar uma string de texto na qual pesquisar um lugar. Por exemplo: "Comida vegetariana picante em Sydney, Austrália" ou "Restaurantes de frutos do mar finos perto Palo Alto, CA".

    Você pode refinar a pesquisa especificando detalhes como níveis de preço, status de abertura atual, classificações ou tipos específicos de lugares. Você também pode especificar para direcionar os resultados a um local específico ou restringir a pesquisa a um local específico.

  • Nearby Search (novo)

    Permite especificar uma região a ser pesquisada com uma lista de tipos de lugar. Especifique a região como um círculo definido pela latitude e longitude coordenadas do ponto central e o raio em metros.

    Especifique um ou mais tipos de lugar que definam as características lugar Por exemplo, especifique "pizza_restaurant" e "shopping_mall" para pesquisar uma pizzaria localizada em um shopping center no na mesma região.

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 determinada área na qual pesquisar.

Autocomplete (novo) e tokens de sessão

O Autocomplete (novo) é um serviço da Web que retorna previsões de lugares e previsões de consultas em resposta a uma solicitação HTTP. Na solicitação, especifique um texto string de pesquisa e limites geográficos que controlam a área de pesquisa.

Os tokens de sessão são strings geradas pelo usuário que acompanham chamadas de preenchimento automático (novo) como de conteúdo. O Autocomplete (novo) usa tokens de sessão para agrupar a consulta e de seleção de uma pesquisa de preenchimento automático do usuário em uma sessão discreta para para fins de cobrança.

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 tempos específicos para determinadas operações. Secundários o horário de funcionamento é diferente do horário de funcionamento principal de uma empresa. Para exemplo, um restaurante pode especificar o horário de funcionamento do drive-thru ou a 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 o campo de opção de pagamento não será definido. As opções incluem:
  • Cartão de crédito
  • Cartão de débito
  • Aceita somente dinheiro
  • pagamento por aproximação
parkingOptions Opções de estacionamento oferecidas pelo local. As opções incluem:
  • Estacionamentos gratuitos
  • Estacionamentos pagos
  • Estacionamento público gratuito
  • Estacionamento com manobrista
  • Estacionamento coberto sem custo financeiro
  • Estacionamento coberto pago
subDestinations Lugares exclusivos relacionados a um determinado lugar. Para por exemplo, terminais de aeroporto são considerados subdestinos de uma aeroporto.
fuelOptions As informações mais recentes sobre as opções de combustível disponíveis em posto de gasolina. Essas informações são atualizadas regularmente. As opções incluem o seguinte:
  • Diesel
  • Sem lead normal
  • Aditivada
  • Premium
  • SP91
  • SP91 E10
  • SP92
  • SP95 E10
  • SP98
  • SP99
  • SP100
  • GLP
  • E80
  • E85
  • Metano
  • Biodiesel
  • Caminhão a diesel
evChargeOptions Número de carregadores de veículos elétricos (VE) nesta estação. alguns carregadores de VE têm vários conectores, e cada carregador 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 O endereço curto e legível de um lugar.
primaryType O tipo principal do resultado fornecido. Por exemplo, um lugar pode classificado como cafe ou airport. Um lugar só pode ter um tipo principal. Para a lista completa valores possíveis, consulte Tipos compatíveis.
primaryTypeDisplayName O nome de exibição do tipo principal, localizado para a solicitação. idioma, se aplicável. Para a lista completa de valores possíveis, consulte Tipos compatíveis.

Atributos

A API Places (nova) inclui vários atributos novos:

Atributo Descrição
outdoorSeating O lugar tem mesas ao ar livre.
liveMusic O local tem música ao vivo.
menuForChildren O lugar tem cardápio infantil.
servesCocktails Local que serve coquetéis.
servesDessert O lugar serve sobremesa.
servesCoffee O local serve café.
goodForChildren O lugar é bom para crianças.
allowsDogs O lugar permite cachorros.
restroom O local tem um banheiro.
goodForGroups O lugar acomoda grupos.
goodForWatchingSports 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 Estacionamento acessível a pessoas em cadeira de rodas.
wheelchairAccessibleEntrance O lugar 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 acessíveis a pessoas em cadeira de rodas.

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 seguinte documentação de migração: