Zur neuen Nearby Search migrieren

Entwickler im Europäischen Wirtschaftsraum (EWR)

Auf dieser Seite werden die Unterschiede zwischen der Nearby Search in der Klasse Place (neu) und der Klasse PlacesService (alt) erläutert. Außerdem finden Sie hier einige Code-Snippets zum Vergleich.

  • Die Legacy-Version von PlacesService bietet die Methode nearbySearch(), mit der Sie anhand eines Suchbegriffs oder Typs nach Orten innerhalb eines bestimmten Bereichs suchen können.
  • Die Klasse Place enthält die Methode searchNearby(), mit der Sie nach Orten innerhalb eines bestimmten Bereichs nach Ortstyp suchen können. Dabei können Sie eine erweiterte Auswahl an Ortsdatenfeldern und Ortstypen verwenden, um mehr Flexibilität zu erhalten.

In der folgenden Tabelle sind einige der wichtigsten Unterschiede zwischen den Nearby Search-Methoden der Klasse Place und PlacesService aufgeführt:

PlacesService (alt) Place (neu)
nearbySearch()
 searchNearby()
PlaceSearchRequest SearchNearbyRequest
Erfordert die Verwendung eines Callbacks, um das Ergebnisobjekt und die google.maps.places.PlacesServiceStatus-Antwort zu verarbeiten. Verwendet Promises und funktioniert asynchron.
Hierfür ist eine PlacesServiceStatus-Prüfung erforderlich. Keine Statusprüfung erforderlich, Standardfehlerbehandlung kann verwendet werden. Weitere Informationen
Unterstützt nur die Standortgewichtung. Unterstützt die Standortgewichtung und die Standortbeschränkung.
Gibt alle verfügbaren Datenfelder zurück (eine Teilmenge der unterstützten Felder). Die Anfrage kann nicht auf bestimmte Felder beschränkt werden. Es werden nur die angeforderten Ortsdatenfelder zurückgegeben. Die Klasse Place bietet eine erweiterte und regelmäßig aktualisierte Auswahl an Feldern.
Auf eine feste Gruppe von Ortstypen beschränkt. Sie können auf eine erweiterte und regelmäßig aktualisierte Auswahl von Ortstypen zugreifen.
Unterstützte textbasierte Suche mit dem keyword. Die textbasierte Suche wird nicht unterstützt. Verwenden Sie stattdessen Text Search (New).

Codevergleich

In diesem Abschnitt wird der Code für Nearby Search-Methoden verglichen, um die Unterschiede zwischen dem Places Service und der Klasse „Place“ zu veranschaulichen. Die Code-Snippets zeigen den Code, der für die jeweilige API erforderlich ist, um eine textbasierte Suchanfrage zu stellen.

Nearby Search (Legacy)

Mit der alten Nearby Search können Sie anhand eines Suchbegriffs oder Typs nach Orten innerhalb eines bestimmten Bereichs suchen. Es ist nicht möglich, Suchanfragen mithilfe von Ortsdatenfeldern einzuschränken. Daher werden bei jeder Anfrage alle verfügbaren Felder zurückgegeben. Im folgenden Snippet wird nearbySearch() aufgerufen, um Informationen zu Restaurants in Sydney, Australien, zurückzugeben. Die Anfrage ist synchron, verwendet einen Callback und enthält eine erforderliche bedingte Prüfung für 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,
  });
}

Weitere Informationen

Nearby Search (New)

Die neue Version von „Nearby Search“ bietet im Vergleich zur Vorgängerversion folgende Verbesserungen:

  • Sie können angeben, welche Ortsdatenfelder zurückgegeben werden sollen.
  • Die Verwendung von Promises, die asynchrone Vorgänge ermöglichen.
  • Der Status von PlacesService muss nicht geprüft werden. Stattdessen kann die Standardfehlerbehandlung verwendet werden.

Das folgende Code-Snippet zeigt eine Funktion, die eine Nearby Search-Anfrage für Restaurants stellt. In diesem Beispiel wird die Option rankPreference verwendet, um Suchergebnisse nach Beliebtheit zu sortieren. In der vorherigen Version wird die Sortierung mit der Option rankBy angegeben. Da die Methode searchNearby() den Operator await verwendet, kann sie nur innerhalb einer async-Funktion verwendet werden.

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");
  }
}

Weitere Informationen