DocumentDB - dane geoprzestrzenne
Microsoft dodał geospatial support, który umożliwia przechowywanie danych lokalizacji w dokumentach i wykonywanie obliczeń przestrzennych dla odległości i przecięć między punktami i wielokątami.
Dane przestrzenne opisują położenie i kształt obiektów w przestrzeni.
Zwykle może służyć do reprezentowania lokalizacji osoby, interesującego miejsca lub granicy miasta lub jeziora.
Typowe przypadki użycia często obejmują zapytania zbliżeniowe. Na przykład „znajdź wszystkie uniwersytety w pobliżu mojej bieżącej lokalizacji”.
ZA Pointoznacza pojedynczą pozycję w przestrzeni, która reprezentuje dokładną lokalizację, np. adres danej uczelni. Punkt jest reprezentowany w DocumentDB za pomocą jego pary współrzędnych (długość i szerokość geograficzna). Poniżej znajduje się przykład punktu JSON.
{
"type":"Point",
"coordinates":[ 28.3, -10.7 ]
}
Przyjrzyjmy się prostemu przykładowi zawierającemu lokalizację uczelni.
{
"id":"case-university",
"name":"CASE: Center For Advanced Studies In Engineering",
"city":"Islamabad",
"location": {
"type":"Point",
"coordinates":[ 33.7194136, -73.0964862 ]
}
}
Aby pobrać nazwę uczelni na podstawie lokalizacji, możesz użyć następującego zapytania.
SELECT c.name FROM c
WHERE c.id = "case-university" AND ST_ISVALID({
"type":"Point",
"coordinates":[ 33.7194136, -73.0964862 ] })
Po wykonaniu powyższego zapytania otrzymasz następujące dane wyjściowe.
[
{
"name": "CASE: Center For Advanced Studies In Engineering"
}
]
Utwórz dokument z danymi geoprzestrzennymi w .NET
Możesz utworzyć dokument z danymi geoprzestrzennymi, spójrzmy na prosty przykład, w którym tworzony jest dokument uniwersytecki.
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();
}
Poniżej znajduje się implementacja dla klasy 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; }
}
Gdy powyższy kod zostanie skompilowany i wykonany, otrzymasz następujące dane wyjściowe.
**** 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