W Cloud Firestore możesz wykonywać zapytania geoprzestrzenne, aby tworzyć usługi z wykrywaniem lokalizacji. Możesz na przykład sprawdzić odległość między użytkownikiem a pobliskimi ciekawymi miejscami i posortować je od najbliższego do najdalszego.
Wymagania dotyczące wersji
Funkcja zapytań geoprzestrzennych wymaga bazy danych Firestore Enterprise.
Zanim zaczniesz
Aby wykonać zapytanie geoprzestrzenne, musisz najpierw utworzyć indeksy geoprzestrzenne dla pól, które chcesz przeszukać.
Uruchamianie zapytania geoprzestrzennego
Aby wykonać zapytanie geoprzestrzenne, użyj wyrażenia geoDistance w parametrze query etapu search(...).
Obsługiwany jest tylko operator mniejsze lub równe (<=). Odległość jest mierzona w metrach.
Na przykład to zapytanie znajduje wszystkie restauracje w promieniu 1000 metrów od podanego punktu geograficznego.
Web
firestore.pipeline().collection('restaurants') .search({ query: field('location') .geoDistance(new GeoPoint(38.989177, -107.065076)) .lessThan(1000 /* m */) });
iOS
firestore.pipeline().collection("restaurants") .search( query: Field("location") .geoDistance(GeoPoint(latitude: 38.989177, longitude: -107.065076)) .lessThan(1000) )
Android
firestore.pipeline() .collection("restaurants") .search(new SearchOptions() .withQuery(field("location") .geoDistance(new GeoPoint(38.989177, -107.065076)) .lessThan(1000 /* meters */)));
Node.js
firestore.pipeline().collection('restaurants') .search({ query: field('location') .geoDistance(new GeoPoint(38.989177, -107.065076)) .lessThan(1000 /* m */) });