Перейти к новому поиску поблизости,Перейти к новому поиску поблизости,Перейти к новому поиску поблизости,Перейти к новому поиску поблизости,Перейти к новому поиску поблизости

На этой странице объясняются различия между поиском поблизости, используемым в классе Place (новый) и PlacesService (устаревший), а также приводятся некоторые фрагменты кода для сравнения.

  • Устаревшая PlacesService имеет метод nearbySearch() , который позволяет искать места в указанной области по ключевому слову или типу.
  • Класс Place имеет метод searchNearby() , который позволяет искать места в указанной области по типу места, используя расширенный выбор полей данных о месте и типов мест для большей гибкости.

В следующей таблице перечислены некоторые основные различия в методах поиска поблизости между классами Place и PlacesService :

PlacesService (устаревшая версия) Place (Новое)
nearbySearch()
 searchNearby()
PlaceSearchRequest SearchNearbyRequest
Требуется использование обратного вызова для обработки объекта результатов и ответа google.maps.places.PlacesServiceStatus . Использует обещания и работает асинхронно.
Требуется проверка PlacesServiceStatus . Не требуется проверка статуса, можно использовать стандартную обработку ошибок.
Поддерживается только смещение местоположения. Поддерживает предвзятость местоположения и ограничение местоположения.
Возвращает все доступные поля данных ( подмножество поддерживаемых полей ); не может быть ограничено конкретными полями. Возвращает только запрошенные поля данных о месте ; Класс Place предлагает расширенный и регулярно обновляемый набор полей.
Ограничено фиксированным набором типов мест . Получите доступ к расширенному и регулярно обновляемому выбору типов мест .
Поддерживается текстовый поиск по ключевому слову . Текстовый поиск не поддерживается. Вместо него используйте текстовый поиск (новый) .

Сравнение кода

В этом разделе сравнивается код методов поиска поблизости, чтобы проиллюстрировать различия между службой Places и классом Place. Фрагменты кода показывают код, необходимый для каждого соответствующего API для выполнения текстового поискового запроса.

Поиск поблизости (старая версия)

Устаревший поиск поблизости позволяет искать места в указанной области по ключевому слову или типу. Невозможно ограничить поиск с помощью полей данных о месте, чтобы все доступные поля возвращались с каждым запросом. В следующем фрагменте кода показано, как вызывается nearbySearch() для возврата информации о ресторанах в Сиднее, Австралия. Запрос является синхронным, использует обратный вызов и включает обязательную условную проверку PlacesServiceStatus .

let map;
let service;

function initMap() {
  const sydney = new google.maps.LatLng(-33.867, 151.195);

  map = new google.maps.Map(document.getElementById("map"), {
    center: sydney,
    zoom: 15,
  });

  const request = {
    location: sydney,
    radius: '500',
    type: ['restaurant']
  };

  service = new google.maps.places.PlacesService(map);
  service.nearbySearch(request, callback);
}

function callback(results, status) {
  if (status == google.maps.places.PlacesServiceStatus.OK) {
    for (var i = 0; i < results.length; i++) {
      createMarker(results[i]);
    }
  }
}

// Helper function to create markers.
function createMarker(place) {
  if (!place.geometry || !place.geometry.location) return;

  const marker = new google.maps.Marker({
    map,
    position: place.geometry.location,
    title: place.name,
  });
}

Узнать больше

Поиск поблизости (новинка)

Новая версия «Поиска поблизости» улучшена по сравнению с предшественницей следующим образом:

  • Возможность указать, какие поля данных места возвращать.
  • Использование обещаний, которое обеспечивает асинхронную работу.
  • Нет необходимости проверять статус PlacesService ; Вместо этого можно использовать стандартную обработку ошибок.

В следующем фрагменте кода показана функция, которая выполняет запрос поиска поблизости для ресторанов. В этом примере показано использование параметра rankPreference для ранжирования результатов поиска по популярности (в предыдущей версии рейтинг задавался с помощью параметра rankBy ). Поскольку метод searchNearby() использует оператор await , его можно использовать только внутри async функции.

async function nearbySearch() {
  // Restrict within the map viewport.
  let center = new google.maps.LatLng(52.369358, 4.889258);
  const request = {
    // Required parameters.
    fields: ["displayName", "location", "businessStatus"],
    locationRestriction: {
      center: center,
      radius: 500,
    },
    // Optional parameters.
    includedPrimaryTypes: ["restaurant"],
    maxResultCount: 5,
    rankPreference: google.maps.places.SearchNearbyRankPreference.POPULARITY,
    language: "en-US",
    region: "us",
  };

  const { places } = await google.maps.places.Place.searchNearby(request);

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

    // Create a new bounds, which will be extended with each result.
    const bounds = new google.maps.LatLngBounds();

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

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

Узнать больше