Place Search

O Place Search introduz o Text Search (novo), que usa uma consulta de texto e retorna um conjunto de lugares.

Text Search (novo)

O Text Search (novo) retorna informações sobre um conjunto de lugares com base em uma string, por exemplo, "pizza em São Paulo", "loja de sapatos perto do Rio de Janeiro" ou "Avenida Brasil, 123". O serviço responde com uma lista de locais correspondentes à string de texto e a todos os direcionamentos de localização definidos. Com o Text Search (novo), você pode pesquisar lugares por tipo, filtrar usando critérios como horário de funcionamento e classificação, além de restringir ou direcionar os resultados para um local específico. O Text Search (novo) é totalmente novo e oferece melhor performance e qualidade de dados do que as APIs Places legadas.

Pré-requisitos

Para usar o Text Search (novo), ative a "API Places (nova)" no projeto do Google Cloud. Consulte o artigo Começar para mais detalhes.

Destaques do Text Search

O Text Search (novo) apresenta as seguintes melhorias:

• Mais filtros de pesquisa, com muitos novos tipos de lugares, além da capacidade de filtrar por classificação mínima.
• Suporte a mascaramento de campo.
• Os campos de local agora incluem classificações e comentários.

Encontrar lugares por consulta de texto

Chame searchByText para retornar uma lista de lugares de uma consulta de texto ou número de telefone. Se a consulta contiver um número de telefone, o parâmetro "region" precisará ser definido como a mesma região do domínio solicitante. Por exemplo, se você usar um número de telefone para pesquisar um lugar no Japão e o domínio solicitante for jp, defina o parâmetro region como "jp". Se region for omitido da solicitação, a API vai adotar como padrão a região dos Estados Unidos ("us").

Use o parâmetro fields para especificar uma lista separada por vírgulas de um ou mais campos de dados com letras concatenadas.

O exemplo a seguir mostra como chamar searchByText para encontrar lugares por consulta de texto.

TypeScript

let map;
let center;

async function initMap() {
    const { Map } = await google.maps.importLibrary("maps") as google.maps.MapsLibrary;

    center = {lat: 37.4161493, lng: -122.0812166};
    map = new Map(document.getElementById('map') as HTMLElement, {
        center: center,
        zoom: 14,
        // ...
    });

    findPlaces();
}

async function findPlaces() {
    const { Place } = await google.maps.importLibrary("places") as google.maps.PlacesLibrary;
    //@ts-ignore
    const { AdvancedMarkerElement } = await google.maps.importLibrary("marker") as google.maps.MarkerLibrary;
    const request = {
        textQuery: 'Tacos in Mountain View',
        fields: ['displayName', 'location', 'businessStatus'],
        includedType: 'restaurant',
        isOpenNow: true,
        language: 'en-US',
        maxResultCount: 7,
        minRating: 3.2,
        region: 'us',
        useStrictTypeFiltering: false,
    };

    //@ts-ignore
    const { places } = await Place.searchByText(request);

    if (places.length) {
        console.log(places);

        const { LatLngBounds } = await google.maps.importLibrary("core") as google.maps.CoreLibrary;
        const bounds = new LatLngBounds();

        // Loop through and get all the results.
        places.forEach((place) => {
            const markerView = new AdvancedMarkerElement({
                map,
                position: place.location,
                title: place.displayName,
            });

            bounds.extend(place.location);
            console.log(place);
        });

        map.setCenter(bounds.getCenter());

    } else {
        console.log('No results');
    }
}

initMap();
index.ts

Observação: acesse o guia sobre como usar o TypeScript e o Google Maps.

JavaScript

let map;
let center;

async function initMap() {
  const { Map } = await google.maps.importLibrary("maps");

  center = { lat: 37.4161493, lng: -122.0812166 };
  map = new Map(document.getElementById("map"), {
    center: center,
    zoom: 14,
    // ...
  });
  findPlaces();
}

async function findPlaces() {
  const { Place } = await google.maps.importLibrary("places");
  //@ts-ignore
  const { AdvancedMarkerElement } = await google.maps.importLibrary("marker");
  const request = {
    textQuery: "Tacos in Mountain View",
    fields: ["displayName", "location", "businessStatus"],
    includedType: "restaurant",
    isOpenNow: true,
    language: "en-US",
    maxResultCount: 7,
    minRating: 3.2,
    region: "us",
    useStrictTypeFiltering: false,
  };
  //@ts-ignore
  const { places } = await Place.searchByText(request);

  if (places.length) {
    console.log(places);

    const { LatLngBounds } = await google.maps.importLibrary("core");
    const bounds = new LatLngBounds();

    // Loop through and get all the results.
    places.forEach((place) => {
      const markerView = new AdvancedMarkerElement({
        map,
        position: place.location,
        title: place.displayName,
      });

      bounds.extend(place.location);
      console.log(place);
    });
    map.setCenter(bounds.getCenter());
  } else {
    console.log("No results");
  }
}

initMap();
index.js