Zur neuen Nearby Search migrieren

Entwickler im Europäischen Wirtschaftsraum (EWR)

Auf dieser Seite werden die Unterschiede zwischen der Suche in der Nähe, wie sie in der Klasse Place (neu) und der Klasse PlacesService (alt) verwendet wird, erläutert und einige Code-Snippets zum Vergleich bereitgestellt.

  • Die alte PlacesService hat eine nearbySearch()-Methode, mit der Sie anhand eines Suchbegriffs oder Typs nach Orten innerhalb eines bestimmten Bereichs suchen können.
  • Die Klasse Place hat eine Methode searchNearby(), mit der Sie nach Orten innerhalb eines bestimmten Bereichs nach Ortstyp suchen können. Dabei wird eine erweiterte Auswahl von Ortsdatenfeldern und Ortstypen verwendet, um eine größere Flexibilität zu ermöglichen.

In der folgenden Tabelle sind einige der wichtigsten Unterschiede bei den Methoden für die Suche in der Nähe zwischen der Klasse Place und PlacesService aufgeführt:

PlacesService (Legacy) Place (Neu)
nearbySearch()
 searchNearby()
PlaceSearchRequest SearchNearbyRequest
Erfordert die Verwendung eines Callbacks zur Verarbeitung des Ergebnisobjekts und der google.maps.places.PlacesServiceStatus-Antwort. Verwendet Promises und funktioniert asynchron.
Hierfür ist eine PlacesServiceStatus-Prüfung erforderlich. Keine Statusprüfung erforderlich, es kann die Standardfehlerbehandlung verwendet werden. Weitere Informationen
Unterstützt nur Standort-Bias. Unterstützt Standortbias und Standortbeschränkung.
Gibt alle verfügbaren Datenfelder zurück (eine Teilmenge der unterstützten Felder). Kann nicht auf bestimmte Felder beschränkt werden. Gibt nur die angeforderten Ortsdatenfelder zurück. Die Place-Klasse bietet eine erweiterte und regelmäßig aktualisierte Auswahl an Feldern.
Auf eine feste Gruppe von Ortstypen beschränkt. Sie haben Zugriff auf eine erweiterte und regelmäßig aktualisierte Auswahl von Ortstypen.
Unterstützte textbasierte Suche mit dem Schlüsselwort. Die textbasierte Suche wird nicht unterstützt. Verwenden Sie stattdessen Text Search (New).

Codevergleich

In diesem Abschnitt wird Code für Methoden zur Suche in der Nähe verglichen, um die Unterschiede zwischen dem Places Service und der Place-Klasse 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 mit 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 der Nearby Search bietet folgende Verbesserungen:

  • Sie können angeben, welche Felder mit Ortsdaten zurückgegeben werden sollen.
  • Die Verwendung von Promises, die einen asynchronen Betrieb ermöglichen.
  • Es ist nicht erforderlich, den Status von PlacesService zu prüfen. 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 wurde 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