Quickstart

This takes you from an empty app to a map a user can draw on. The map itself needs no key; if you want to fill it with LOCI frames instead of your own boundaries, Frames is the next step.

Add the package

Point to the package by path or git.

pubspec.yaml

dependencies:
  milsat_map:
    path: ../milsat_map # or a git dependency

Then run the platform setup for Android and iOS.

Initialise, only if you use frames

The map works without a key. If you preload frames, initialise the SDK once with your API key, for example in main. Create the key in your LOCI dashboard under Developers → New key; see Authentication.

lib/main.dart

await MilsatMaps.initialize(apiKey: '<your key>');

Drop in the widget

Give it what the user may draw and the work areas. The map works out of the box.

lib/survey_map.dart

import 'package:milsat_map/milsat_map.dart';

MilsatMap(
  options: const MapOptions(
    mapId: 'survey-1',
    geometry: DrawGeometry.point,
  ),
  workAreas: MapWorkArea.listFromEsri(esriQueryResponse),
  onSave: (data) => saveEntry(data),
)

Run it

terminal

flutter run

Tap Draw, tap inside a visible work area, then Save. onSave receives a DataFromMap — see what you get back.

The example app

The package ships an example app whose first screen is the preload step. Run it from example. Nothing you type is saved: the frames key stays in memory and is gone when the app closes. The map screen shows only what was preloaded.

run on iOS or Android

cd example
flutter devices
# iOS simulator
flutter run -d <simulator id> --dart-define=FRAMES_KEY=<your frames key>
xcrun simctl location booted set 9.0579,7.4951
# Android emulator or device
flutter run -d <android device id> --dart-define=FRAMES_KEY=<your frames key>
adb emu geo fix 7.4951 9.0579

The --dart-define value is optional: leave it out and type the frames key on the first screen. Do not commit the key.

Part of the screen	What it does
Frames access key	Authorises the frames requests. Masked. Filled in from `FRAMES_KEY`, and read again for every request.
Frame ids tab	Paste ids separated by commas, spaces or line breaks. Anything that is not digits is flagged.
By location tab	Type a latitude and longitude, or tap Use my location, then Find frame. Adds the frame id under the point.
From a work area tab	Use the built-in sample polygon, or paste a GeoJSON polygon, then Find frame. Uses `frameFromWorkArea`.
Sample frames	Adds four ids for a quick try.
Hidden layer ids	Optional. Layers you do not want on the work areas.
Source and pack id	Cloud, pack only or pack first, and the pack to use.
Load frames	Shows how many frames loaded, which ids were missing, what was billed, what was left out, truncation warnings and requests used.
Open map	Shows the preloaded frames as visible work areas.
Skip (demo data)	Goes to the original demo with no keys.

A release build of the Android example:

release APK

cd example
flutter build apk --release

Flutter

Native

The example app

​The example app

The example app