Link para o Google Maps

A API Places (nova) aceita solicitações de dados de lugares por vários métodos. A resposta da API Places (nova) 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 (nova), da Nearby Search (nova) e da Place Details (nova) também pode conter links para o Google Maps. Os 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, na Califórnia. A resposta inclui o Aeroporto Internacional de São Francisco (SFO) na lista de lugares. O Place objeto para SFO na resposta adiciona o campo googleMapsUri contendo links do Google Maps para abrir o Google Maps para o lugar, direções para o lugar, avaliações do lugar e fotos do lugar.

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

  • Reviews.googleMapsUri: contém um link do Maps para a avaliação, para que você possa conferi-la em um navegador.

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

O API Explorer permite fazer solicitações em tempo real para que você possa se familiarizar com essas novas opções:

Faça um teste

A tabela a seguir mostra os links do Google Maps que podem ser incluídos na resposta:

Link do Maps Descrição Nome do campo
Lugar Link para abrir o Google Maps no lugar. googleMapsLinks.placeUri
Rotas Link para abrir rotas para 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 lugar no Google Maps. googleMapsLinks.reviewsUri
Fotos Link para mostrar fotos do lugar no Google Maps. googleMapsLinks.photosUri

Os links na resposta da API Places estão contidos no googleMapsLinks campo. Inclua o campo googleMapsLinks na máscara de campo da solicitação se quiser que eles apareçam na resposta.

Por exemplo, a Pesquisa de texto (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"
      }
    }
  ]
}

Não é necessário retornar todos os links na resposta. Por exemplo, se você quiser apenas o link de 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 da API Places oferecem suporte à 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

Esta versão adiciona 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.

Faça um teste

O API Explorer permite fazer solicitações de amostra para que você possa se familiarizar com a API e as opções dela.

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

  2. Se quiser, expenda Mostrar parâmetros padrão e defina o fields parâmetro 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

    Tela cheia para expandir a janela do API Explorer.