Tipos de dados geoespaciais - .NET SDK

GeoPoint

Um GeoPoint define um local específico na superfície da Terra. Todos os tipos de dados geoespaciais utilizam GeoPoints para definir sua localização.

Círculo geográfico

Um GeoCircle define um círculo na superfície da Terra. Você define um GeoCircle fornecendo um GeoPoint para o centro do círculo e um objeto de distância para especificar o raio do círculo.

O seguinte código mostra dois exemplos de criação de um círculo:

var circle1 = new GeoCircle((47.8, -122.6),
    Distance.FromKilometers(44.4));
var circle2 = new GeoCircle(
    new GeoPoint(latitude: 47.3, longitude: -121.9),
    Distance.FromDegrees(0.25));

clique para ampliar

GeoBox

Uma GeoBox define um retângulo na superfície da Terra. Você define o retângulo especificando o canto inferior esquerdo (sudoeste) e o canto superior direito (nordeste). O exemplo a seguir cria 2 caixas:

var box1 = new GeoBox(bottomLeftCorner: (47.3, -122.7),
    topRightCorner: (48.1, -122.1));
var box2 = new GeoBox(new GeoPoint(47.5, -122.4),
   new GeoPoint(47.9, -121.8));

clique para ampliar

GeoPolygon

Um GeoPolygon define um polígono na superfície da Terra. Como um polígono é uma forma fechada, você deve fornecer um mínimo de 4 pontos: 3 pontos para definir a forma do polígono e um quarto para fechar a forma.

Você também pode excluir áreas dentro de um polígono definindo um ou mais "furos". Um orifício é outro polígono cujos limites se encaixam completamente dentro do polígono externo. O exemplo abaixo cria 3 polígonos: um é um polígono básico com 5 pontos, um é o mesmo polígono com um único orifício e o terceiro é o mesmo polígono com dois orifícios:

var basicPolygon = new GeoPolygon((48, -122.8),
    (48.2, -121.8), (47.6, -121.6), (47.0, -122.0),
    (47.2, -122.6), (48, -122.8));
// Create a polygon with a single hole
var outerRing = new GeoPoint[] {
    (48, -122.8), (48.2, -121.8),
    (47.6, -121.6), (47.0, -122.0), (47.2, -122.6),
    (48, -122.8) };
var hole1 = new GeoPoint[] {
    (47.8, -122.6), (47.7, -122.2),
    (47.4, -122.6), (47.6, -122.5),
    (47.8, -122.6) };
var polygonWithOneHole = new GeoPolygon(outerRing, hole1);
// Add a second hole to the polygon
var hole2 = new GeoPoint[] {
    (47.55, -122.05), (47.5, -121.9),(47.3, -122.1),
    (47.55, -122.05) };
var polygonWithTwoHoles =
    new GeoPolygon(outerRing, hole1, hole2);

clique para ampliar

Criando uma classe compatível com GeoJSON

Para criar uma classe que esteja em conformidade com a especificação GeoJSON, você:

1. Crie um objeto de domínio incorporado (uma classe que herda de IEmbeddedObject).

2. No mínimo, adicione os dois campos exigidos pela especificação GeoJSON:

   • Um campo do tipo IList<double> que mapeia para uma propriedade de "coordenadas" (diferencia maiúsculas de minúsculas) no esquema do Realm.

   • Um campo do tipo string que mapeia para uma propriedade "type". O valor deste campo deve ser "Ponto".

O exemplo seguinte mostra uma classe incorporada denominada "CustomGeoPoint" que é utilizada para persistir os dados do GeoPoint:

public partial class CustomGeoPoint : IEmbeddedObject
{
    [MapTo("coordinates")]
    public IList<double> Coordinates { get; } = null!;
    [MapTo("type")]
    private string Type { get; set; } = "Point";
    public CustomGeoPoint(double latitude, double longitude)
    {
        Coordinates.Add(longitude);
        Coordinates.Add(latitude);
    }
}

Usando a classe incorporada

Em seguida, você usa a classe GeoPoint personalizada em seu modelo de Realm, conforme mostrado no exemplo a seguir:

public partial class Company : IRealmObject
{
    [PrimaryKey]
    [MapTo("_id")]
    public Guid Id { get; private set; } = Guid.NewGuid();
    public CustomGeoPoint? Location { get; set; }
    public Company() { }
}

Em seguida, você adiciona instâncias de sua classe ao domínio como qualquer outro modelo Realm:

realm.WriteAsync(() =>
{
    realm.Add(new Company
    {
        Location = new CustomGeoPoint(47.68, -122.35)
    });
    realm.Add(new Company
    {
        Location = new CustomGeoPoint(47.9, -121.85)
    });
});

A imagem a seguir mostra os resultados da criação desses dois objetos de empresa.

clique para ampliar