A API Places aceita solicitações de dados de lugar por vários métodos. A resposta da API Places contém dados sobre um lugar, incluindo dados de local e imagens, locais geográficos e pontos de interesse importantes.
Com essa versão, a resposta da Pesquisa de texto, da Pesquisa por proximidade e dos detalhes do lugar também pode conter links para o Google Maps. Os usuários podem navegar para esses links do Google Maps para conferir mais informações sobre um lugar na resposta.
Por exemplo, você pesquisa aeroportos em São Francisco, na Califórnia. A resposta
inclui o Aeroporto Internacional de São Francisco (SFO) na lista de lugares.
Com essa versão, o objeto Place para SFO na resposta adiciona o campo googleMapsUri com links do Google Maps para abrir o Maps no lugar, direções para o lugar, avaliações do lugar e fotos do lugar.
Além dos links adicionados ao objeto Place, esta versão também adiciona o campo googleMapsUri aos objetos Reviews e Photos na resposta:
Reviews.googleMapsUri: contém um link do Google Maps para a avaliação, para que você possa acessá-la em um navegador.Photos.googleMapsUri: contém um link do Google Maps para a foto, para que você possa visualizá-la em um navegador.
O API Explorer permite fazer solicitações em tempo real para que você se familiarize com estas novas opções:
Links do Google Maps com suporte para um lugar
A tabela a seguir mostra os links do Google Maps que podem ser incluídos na resposta:
| Link do Google Maps | Descrição | Nome do campo |
|---|---|---|
| Lugar | Link para abrir o Google Maps no lugar. | googleMapsLinks.placeUri |
| Rotas | Link para abrir rotas até o lugar no Google Maps. | googleMapsLinks.directionsUri |
| Escrever uma avaliação | Link para escrever uma avaliação do lugar no Google Maps. | googleMapsLinks.writeAReviewUri |
| Ler avaliações | Link para mostrar as avaliações do Google Maps do lugar. | googleMapsLinks.reviewsUri |
| Fotos | Link para mostrar fotos do lugar no Google Maps. | googleMapsLinks.photosUri |
Preços
Esse recurso está na fase de pré-lançamento e não tem cobrança, ou seja, o faturamento é de US $0,00, para uso durante a fase de pré-lançamento. Para detalhes sobre o preço proposto, consulte Uso e faturamento da API Places.
Incluir todos os links na resposta do Places
Os links na resposta de lugares estão contidos no campo
googleMapsLinks. Inclua o campo googleMapsLinks na máscara de campo da solicitação se quiser que ele apareça na resposta.
Por exemplo, a pesquisa de texto a seguir inclui todos os links do Maps na resposta:
curl -X POST -d '{
"textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY ' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'
A resposta está no formato:
{
"places": [
{
"formattedAddress": "San Francisco, CA 94128, USA",
"displayName": {
"text": "San Francisco International Airport",
"languageCode": "en"
},
"googleMapsLinks": {
"placeUri": "https://maps.google.com/?cid=11885663895765773631",
"directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
"writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
"reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
"photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
}
}
]
}Incluir um link específico na resposta
Não é preciso retornar todos os links na resposta. Por exemplo, se você quiser apenas
o link das fotos na resposta, modifique a máscara de campo conforme mostrado abaixo para
incluir apenas o campo photosUri:
curl -X POST -d '{
"textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY ' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'
Incluir instruções na resposta
Todos os métodos do Places oferecem suporte à geração do link de direções na resposta. O local atual é usado como origem, o local do lugar é usado como destino e o modo de transporte é carro.
O próximo exemplo usa a Pesquisa nas proximidades para incluir o link de rotas do Maps na resposta no campo directionsUri:
curl -X POST -d '{
"includedTypes": ["restaurant"],
"maxResultCount": 10,
"locationRestriction": {
"circle": {
"center": {
"latitude": -33.8688,
"longitude": 151.1957362},
"radius": 500.0
}
}
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY ' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby
Incluir links de avaliações e fotos
Nesta versão, adicionamos o campo googleMapsUri aos objetos
Reviews
e
Photos
na resposta. A navegação para esses links abre a avaliação ou a foto no Google Maps.
Por exemplo, a Pesquisa de texto a seguir inclui avaliações e fotos para cada lugar na resposta:
curl -X POST -d '{
"textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY ' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'
Na resposta, cada elemento da matriz de avaliações e fotos contém o
campo googleMapsUri para abrir a avaliação ou foto em um navegador.
Confira!
O API Explorer permite fazer solicitações de amostra para que você se familiarize com a API e as opções dela.
Selecione o ícone da API,
, no lado
direito da página.Opcionalmente, abra Mostrar parâmetros padrão e defina o parâmetro
fieldscomo a máscara de campo.Se preferir, edite o corpo da solicitação.
Selecione o botão Executar. Na caixa de diálogo, escolha a conta que você quer usar para fazer a solicitação.
No painel do API Explorer, selecione o ícone de expansão
para abrir a janela do API Explorer.