DocumentDB - Геопространственные данные
Microsoft добавила geospatial support, который позволяет хранить данные о местоположении в ваших документах и выполнять пространственные вычисления для расстояний и пересечений между точками и многоугольниками.
Пространственные данные описывают положение и форму объектов в пространстве.
Как правило, его можно использовать для обозначения местоположения человека, достопримечательности, границы города или озера.
Общие варианты использования часто включают запросы близости. Например, «найти все университеты рядом с моим текущим местоположением».
А Pointобозначает одну позицию в пространстве, которая представляет точное местоположение, например, адрес конкретного университета. Точка представлена в DocumentDB с использованием пары координат (долгота и широта). Ниже приведен пример точки JSON.
{
"type":"Point",
"coordinates":[ 28.3, -10.7 ]
}
Давайте посмотрим на простой пример, который содержит расположение университета.
{
"id":"case-university",
"name":"CASE: Center For Advanced Studies In Engineering",
"city":"Islamabad",
"location": {
"type":"Point",
"coordinates":[ 33.7194136, -73.0964862 ]
}
}
Чтобы получить название университета на основе местоположения, вы можете использовать следующий запрос.
SELECT c.name FROM c
WHERE c.id = "case-university" AND ST_ISVALID({
"type":"Point",
"coordinates":[ 33.7194136, -73.0964862 ] })
Когда вышеуказанный запрос будет выполнен, вы получите следующий результат.
[
{
"name": "CASE: Center For Advanced Studies In Engineering"
}
]
Создать документ с геопространственными данными в .NET
Вы можете создать документ с геопространственными данными, давайте рассмотрим простой пример, в котором создается университетский документ.
private async static Task CreateDocuments(DocumentClient client) {
Console.WriteLine();
Console.WriteLine("**** Create Documents ****");
Console.WriteLine();
var uniDocument = new UniversityProfile {
Id = "nust",
Name = "National University of Sciences and Technology",
City = "Islamabad",
Loc = new Point(33.6455715, 72.9903447)
};
Document document = await CreateDocument(client, uniDocument);
Console.WriteLine("Created document {0} from typed object", document.Id);
Console.WriteLine();
}
Ниже приведена реализация класса UniversityProfile.
public class UniversityProfile {
[JsonProperty(PropertyName = "id")]
public string Id { get; set; }
[JsonProperty("name")]
public string Name { get; set; }
[JsonProperty("city")]
public string City { get; set; }
[JsonProperty("location")]
public Point Loc { get; set; }
}
Когда приведенный выше код скомпилирован и выполнен, вы получите следующий вывод.
**** Create Documents ****
Created new document: nust
{
"id": "nust",
"name": "National University of Sciences and Technology",
"city": "Islamabad",
"location": {
"type": "Point",
"coordinates": [
33.6455715,
72.9903447
]
},
"_rid": "Ic8LAMEUVgANAAAAAAAAAA==",
"_ts": 1450200910,
"_self": "dbs/Ic8LAA==/colls/Ic8LAMEUVgA=/docs/Ic8LAMEUVgANAAAAAAAAAA==/",
"_etag": "\"00004100-0000-0000-0000-56704f4e0000\"",
"_attachments": "attachments/"
}
Created document nust from typed object