Poznámka:
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
Fáze $geoNear agregace vypočítá vzdálenosti mezi zadaným bodem a polem umístění v každém dokumentu, seřadí dokumenty podle vzdálenosti a může volitelně omezit výsledky podle vzdálenosti.
Syntaxe
{
$geoNear: {
near: {
type: "Point",
coordinates: [<longitude>, <latitude>]
},
distanceField: <field to store distance>,
maxDistance: <optional maximum distance in meters>,
minDistance: <optional minimum distance in meters>,
query: <optional query conditions>,
includeLocs: <optional boolean to include locations>,
distanceMultiplier: <optional distance multiplier>,
spherical: <boolean, must be true>,
key: <optional field path>
}
}
Parametry
| Parameter | Typ | Description |
|---|---|---|
near |
Object | Bod, ze kterého se mají vypočítat vzdálenosti |
distanceField |
String | Pole, které obsahuje vypočítanou vzdálenost |
maxDistance |
Number | Optional. Maximální vzdálenost v metrech od bodu |
minDistance |
Number | Optional. Minimální vzdálenost v metrech od bodu |
query |
Dokument | Volitelné podmínky dotazu |
includeLocs |
logický | Optional. Zahrnout lokality do výsledků |
distanceMultiplier |
Number | Optional. Vynásobte vzdálenosti touto hodnotou |
spherical |
logický | Musí být pravdivé pro 2dsphere indexy. |
key |
String | Optional. Cesta pole, která se má použít pro výpočet vzdáleností |
Examples
Podívejte se na tento ukázkový dokument z kolekce stores.
{
"_id": "2cf3f885-9962-4b67-a172-aa9039e9ae2f",
"name": "First Up Consultants | Bed and Bath Center - South Amir",
"location": {
"lat": 60.7954,
"lon": -142.0012
},
"staff": {
"totalStaff": {
"fullTime": 18,
"partTime": 17
}
},
"sales": {
"totalSales": 37701,
"salesByCategory": [
{
"categoryName": "Mattress Toppers",
"totalSales": 37701
}
]
},
"promotionEvents": [
{
"eventName": "Price Drop Palooza",
"promotionalDates": {
"startDate": {
"Year": 2024,
"Month": 9,
"Day": 21
},
"endDate": {
"Year": 2024,
"Month": 9,
"Day": 30
}
},
"discounts": [
{
"categoryName": "Bath Accessories",
"discountPercentage": 18
},
{
"categoryName": "Pillow Top Mattresses",
"discountPercentage": 17
}
]
}
]
}
Příklad 1: Výpočet základní vzdálenosti
Tento dotaz načte všechny obchody v blízkosti umístění VanArsdel Picture Frame Store seřazené podle vzdálenosti:
db.stores.aggregate([
{
$geoNear: {
near: {
type: "Point",
coordinates: [-141.9922, 16.8331] // VanArsdel Picture Frame Store location
},
distanceField: "distance",
spherical: true
}
},
{
$project: {
name: 1,
distance: 1
}
}
])
První tři výsledky vrácené tímto dotazem jsou:
[
{
"_id": "643b2756-c22d-4063-9777-0945b9926346",
"name": "Contoso, Ltd. | Outdoor Furniture Corner - Pagacfort",
"distance": 5458613.2813355485
},
{
"_id": "daa71e60-75d4-4e03-8b45-9df59af0811f",
"name": "First Up Consultants | Handbag Corner - South Salvatore",
"distance": 5469362.958855379
},
{
"_id": "02a78a15-b1fc-4bbd-ae1d-641b7428dc78",
"name": "VanArsdel, Ltd. | Kitchen Appliance Corner - Llewellynberg",
"distance": 5472684.4628977
}
]
Příklad 2: S limity vzdálenosti a volitelným dotazem
Tento dotaz načte všechny obchody v rámci 30 KM od "Proseware Home Entertainment Hub", které mají více než 10 zaměstnanců na plný úvazek:
db.stores.aggregate([
{
$geoNear: {
near: {
type: "Point",
coordinates: [69.7296, 70.1272] // "Proseware Home Entertainment Hub" location
},
distanceField: "distance",
maxDistance: 30000, // 30 kilometers in meters
query: { "staff.totalStaff.fullTime": { $gt: 10 } },
spherical: true
}
},
{
$project: {
name: 1,
distance: 1,
"staff.totalStaff.fullTime": 1
}
}
])
První výsledek vrácený tímto dotazem je:
[
{
"_id": "bbec6d3e-1666-45b4-8803-8b7ef8544845",
"name": "First Up Consultants | Baby Products Bargains - South Keenan",
"staff": {
"totalStaff": {
"fullTime": 19
}
},
"distance": 29934.71888123174
}
]
Příklad 3: Zahrnutí dat o poloze a násobitele vzdálenosti
Tento dotaz načte úložiště s vzdáleností v kilometrech a zahrnutými daty o poloze:
db.stores.aggregate([
{
$geoNear: {
near: {
type: "Point",
coordinates: [-38.4071, -47.2548] // "Fabrikam Car Accessory Outlet" location
},
distanceField: "distanceInKm",
includeLocs: "storeLocation",
distanceMultiplier: 0.001, // Convert meters to kilometers
spherical: true
}
},
{
$project: {
name: 1,
distanceInKm: 1,
storeLocation: 1
}
}
])
První tři výsledky vrácené tímto dotazem jsou:
[
{
"_id": "b677846e-bb73-46ec-9cba-7d94afee382c",
"name": "Northwind Traders | Health Food Shoppe - Brooklynmouth",
"storeLocation": {
"lat": -38.3032,
"lon": -132.7866
},
"distanceInKm": 9.095634270192285
},
{
"_id": "27c64b44-2382-4477-b3ce-c08e74882156",
"name": "Relecloud | VR Headset Gallery - West Jonasbury",
"storeLocation": {
"lat": -37.9628,
"lon": -132.6637
},
"distanceInKm": 34.7104536140246
},
{
"_id": "505e83eb-09bc-46a4-ba85-16135611b9de",
"name": "Fabrikam, Inc. | Pharmacy Hub - Elijahville",
"storeLocation": {
"lat": -38.0349,
"lon": -47.9571
},
"distanceInKm": 82.92766541748313
}
]
Omezení
- Nejde použít s horizontálně dělenými kolekcemi
- Pouze jedna fáze $geoNear na potrubí
- Musí to být první fáze potrubí.
Související obsah
- Projděte si možnosti migrace z MongoDB do Azure DocumentDB.
- Přečtěte si další informace o kompatibilitě funkcí s MongoDB.