Geoespacial - Flutter SDK

GeoPoint

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

Um GeoPoint é um objeto com duas propriedades obrigatórias:

• lat: um valor duplo

• lon: um valor duplo

Um GeoPoint é utilizado somente como um bloco de construção das outras formas: GeoCircle e GeoBox. Estas formas e o tipo GeoPoint são usados em queries, não para persistência.

Para salvar dados geoespaciais no banco de dados, consulte Persistir Dados Geoespaciais.

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

• Um GeoDistance para a distância (raio) do círculo

A distância de raio usa radianos como unidade de medida, implementado como um valor duplo no SDK. O SDK fornece métodos de conveniência para criar um GeoDistance a partir de outras unidades de medida:

• GeoDistance.fromDegrees()

• GeoDistance.fromKilmeters()

• GeoDistance.fromMeters()

• GeoDistance.fromMiles()

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

final smallCircle =
    GeoCircle(GeoPoint(lon: -121.9, lat: 47.3), 0.25.degrees);
final largeCircleCenter = GeoPoint(lon: -122.6, lat: 47.8);
// The SDK provides convenience methods to convert measurements to radians.
final radiusFromKm = GeoDistance.fromKilometers(44.4);
final largeCircle = GeoCircle(largeCircleCenter, radiusFromKm);

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:

final largeBox = GeoBox(
    GeoPoint(lon: -122.7, lat: 47.3), GeoPoint(lon: -122.1, lat: 48.1));
final smallBoxSouthWest = GeoPoint(lon: -122.4, lat: 47.5);
final smallBoxNorthEast = GeoPoint(lon: -121.8, lat: 47.9);
final smallBox = GeoBox(smallBoxSouthWest, smallBoxNorthEast);

clique para ampliar

Criar uma classe compatível com GeoJSON

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

1. Crie um objeto incorporado. Para obter mais informações sobre objetos incorporados, consulte Objetos incorporados.

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

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

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

O exemplo seguinte mostra uma classe embarcada denominada MyGeoPoint que é utilizada para persistir dados geoespaciais:

// To store geospatial data, create an embedded object with this structure.
// Name it whatever is most convenient for your application.
@RealmModel(ObjectType.embeddedObject)
class _MyGeoPoint {
  // These two properties are required to persist geo data.
  final String type = 'Point';
  final List<double> coordinates = const [];
  // You can optionally implement convenience methods to simplify
  // creating and working with geospatial data.
  double get lon => coordinates[0];
  set lon(double value) => coordinates[0] = value;
  double get lat => coordinates[1];
  set lat(double value) => coordinates[1] = value;
  GeoPoint toGeoPoint() => GeoPoint(lon: lon, lat: lat);
}

Use a classe incorporada

Em seguida, use a classe MyGeoPoint personalizada em seu modelo de dados, conforme mostrado no exemplo a seguir:

// Use the GeoJSON-compatible class as a property in your model.
@RealmModel()
class _Company {
  @PrimaryKey()
  late ObjectId id;
  _MyGeoPoint? location;
}

Você adiciona instâncias de sua classe ao banco de dados como qualquer outro modelo.

final realm =
    Realm(Configuration.local([MyGeoPoint.schema, Company.schema]));
realm.write(() {
  realm.addAll([
    Company(
      firstCompanyID,
      location: MyGeoPoint(coordinates: [-122.35, 47.68]),
    ),
    Company(
      secondCompanyID,
      location: MyGeoPoint(coordinates: [-121.85, 47.9]),
    )
  ]);
});

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

clique para ampliar