Ortsfeldmigration (open_now, utc_offset)

Die „Places“-Felder opening_hours.open_now und utc_offset wurden am 20. November 2019 eingestellt und am 20. Februar 2021 deaktiviert. Diese Felder wurden NUR in der Places Library, Maps JavaScript API eingestellt. In dieser Anleitung erfahren Sie, wie Sie Ihren Code so aktualisieren, dass diese Felder nicht mehr verwendet werden.

Feld opening_hours.open_now

In diesem Abschnitt wird beschrieben, wie Sie diese Funktion für die verschiedenen Arten von „Places“-Anfragen aktualisieren.

„Place Details“-Anfragen

Das Feld opening_hours.open_now wird durch die Methode opening_hours.isOpen() ersetzt.

Anstatt bei „Place Details“-Anfragen das Feld opening_hours.open_now im Anfrageparameter fields anzufordern, fügen Sie opening_hours und utc_offset_minutes in den Anfrageparameter fields ein. Danach rufen Sie die Methode opening_hours.isOpen() für das zurückgegebene google.maps.places.PlaceResult-Objekt auf, um herauszufinden, ob der Ort geöffnet ist. Das folgende Beispiel zeigt eine „Places Details“-Anfrage, mit der herausgefunden wird, ob ein Ort geöffnet ist:

new google.maps.places.PlacesService(attrContainer).getDetails({
  placeId: '...',
  fields: ['opening_hours','utc_offset_minutes'],
  }, function (place, status) {
    if (status !== 'OK') return; // something went wrong
    const isOpenAtTime = place.opening_hours.isOpen(new Date('December 17, 2020 03:24:00'));
    if (isOpenAtTime) {
        // We know it's open.
    }

    const isOpenNow = place.opening_hours.isOpen();
    if (isOpenNow) {
        // We know it's open.
    }
});

„Find Place“-Anfragen

Für „Find Place“-Anfragen kann das Feld opening_hours.open_now nicht ersetzt werden. Wir empfehlen, eine „Place Details“-Anfrage zu senden, um opening_hours-Informationen abzurufen.

„Nearby Search“- und „Text Search“-Anfragen

Für „Nearby Search“- und „Text Search“-Anfragen können Sie den Anfrageparameter openNow verwenden. Dadurch werden die Ergebnisse so gefiltert, dass nur Orte angezeigt werden, die derzeit geöffnet sind.

  • openNow:false gibt alle Orte zurück.
  • openNow:true gibt nur Orte zurück, die derzeit geöffnet sind.

Wenn Sie alle Orte UND den openNow-Status sehen möchten, müssen Sie zuerst eine Anfrage mit openNow:false senden, um alle Orte abzurufen, und dann eine Anfrage mit openNow:true, um nur geöffnete Orte abzurufen. Danach führen Sie die Antworten zusammen.

Feld utc_offset

In „Place Details“-Anfragen wird das Feld utc_offset durch das Feld utc_offset_minutes ersetzt. Ersetzen Sie das Feld utc_offset im Anfrageparameter fields und beim Abrufen dieser Informationen aus PlaceResult einfach überall durch das Feld utc_offset_minutes.