Link para o Google Maps

A API Places (New) aceita solicitações de dados de lugares por vários métodos. A resposta da API Places (New) contém dados sobre um lugar, incluindo dados de localização e imagens, locais geográficos e pontos de interesse importantes.

A resposta da Text Search (novo), da Nearby Search (novo) e do Place Details (novo) também pode conter links para o Google Maps. Seus usuários podem acessar esses links do Google Maps para conferir mais informações sobre um lugar na resposta.

Por exemplo, você pesquisa aeroportos em São Francisco, Califórnia. A resposta inclui o Aeroporto Internacional de São Francisco (SFO) na lista de lugares. O objeto Place para SFO na resposta adiciona o campo googleMapsUri, que contém links do Google Maps para abrir o lugar, rotas para o lugar, avaliações e fotos.

Além dos links adicionados ao objeto Place, o campo googleMapsUri também é adicionado aos objetos Reviews e Photos na resposta:

• Reviews.googleMapsUri: contém um link do Maps para a avaliação, assim você pode conferir em um navegador.

• Photos.googleMapsUri: contém um link do Maps para a foto para que você possa vê-la em um navegador.

Com o API Explorer, você pode fazer solicitações em tempo real para se familiarizar com estas novas opções:

Faça um teste

Links do Google Maps compatíveis para um lugar

A tabela a seguir mostra os links do Google Maps que você pode incluir na resposta:

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 eles apareçam na resposta.

Por exemplo, a Text Search (nova) 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 é necessário 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 rotas na resposta

Todos os métodos Places são compatíveis com a geração do link de rotas na resposta. O local atual é usado como origem, o local do lugar é usado como destino, e o modo de viagem é de carro.

O exemplo a seguir usa a Nearby Search (nova) 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. Ao acessar esses links, a avaliação ou foto é aberta no Google Maps.

Por exemplo, a Text Search (nova) a seguir inclui avaliações e fotos de 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!

Com o API Explorer, você pode fazer solicitações de amostra para se familiarizar com a API e as opções dela.

1. Selecione o ícone da API api no lado direito da página.

2. Se quiser, expanda Mostrar parâmetros padrão e defina o parâmetro fields como a máscara de campo.

3. Se quiser, edite o corpo da solicitação.

4. Selecione o botão Executar. Na caixa de diálogo, escolha a conta que você quer usar para fazer a solicitação.

5. No painel do API Explorer, selecione fullscreen .

   Tela cheia para expandir a janela do API Explorer.