Geoespacial - Flutter SDK

GeoPoint

Un GeoPointDefine una ubicación específica en la superficie terrestre. Todos los tipos de datos geoespaciales utilizan GeoPoints para definir su ubicación.

Un(a) GeoPoint es un objeto con dos propiedades obligatorias:

• lat: un valor double

• lon: un valor double

A GeoPoint is used only as a building block of the other shapes: GeoCircle and GeoBox. These shapes, and the GeoPoint type, are used in queries, not for persistance.

Para guardar datos geoespaciales en la base de datos, consulte Persistir datos geoespaciales.

GeoCírculo

A GeoCircle defines a circle on the Earth's surface. You define a GeoCircle by providing:

• Un GeoPoint para el centro del círculo

• A GeoDistance for the distance (radius) of the circle

La distancia radial utiliza radianes como unidad de medida, implementados como un doble en el SDK. El SDK proporciona métodos prácticos para crear un GeoDistance a partir de otras unidades de medida:

• GeoDistance.fromDegrees()

• GeoDistance.fromKilometers()

• GeoDistance.fromMeters()

• GeoDistancia.fromMiles()

El siguiente código muestra dos ejemplos de cómo crear un 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);

haga clic para ampliar

GeoBox

A GeoBox defines a rectangle on the Earth's surface. You define the rectangle by specifying the bottom left (southwest) corner and the top right (northeast) corner.

El siguiente ejemplo crea 2 cajas:

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);

haga clic para ampliar

Create a GeoJSON-Compatible Class

Para crear una clase que se ajuste a la especificación GeoJSON, debes:

1. Create an embedded object. For more information about embedded objects, refer to Embedded Objects.

2. Como mínimo, agregue los dos campos requeridos por la especificación GeoJSON:

   • A field of type double[] that maps to a "coordinates" (case sensitive) property in the schema.

   • Un campo de tipo string que se asigna a una propiedad "tipo". El valor de este campo debe ser "punto".

The following example shows an embedded class named MyGeoPoint that is used to persist geospatial data:

// 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 the Embedded Class

Luego, utiliza la clase personalizada MyGeoPoint en tu modelo de datos, como se muestra en el siguiente ejemplo:

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

Añade instancias de tu clase a la base de datos como cualquier otro 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]),
    )
  ]);
});

The following image shows the results of creating these two company objects.

haga clic para ampliar