new change to use intaleq_map sdk v2 04-17-1

This commit is contained in:
Hamza-Ayed
2026-04-17 14:47:11 +03:00
parent 834c220d31
commit cc62019609
16 changed files with 1436 additions and 357 deletions
@@ -1,105 +1,363 @@
import 'dart:convert';
import 'dart:math';
import 'dart:typed_data';
import 'package:flutter/services.dart' show rootBundle;
import 'package:http/http.dart' as http;
import 'package:maplibre_gl/maplibre_gl.dart' hide CircleOptions;
import 'package:maplibre_gl/maplibre_gl.dart' as mgl;
import 'models/geometry.dart';
import 'models/bitmap.dart';
/// Controls a live [IntaleqMap] widget.
///
/// Obtain a reference via the [IntaleqMap.onMapCreated] callback.
/// This API mirrors [GoogleMapController] from `google_maps_flutter`.
class IntaleqMapController {
final MaplibreMapController mapController;
final String apiKey;
IntaleqMapController._({
required mgl.MaplibreMapController raw,
required String apiKey,
}) : _raw = raw,
_apiKey = apiKey;
IntaleqMapController({
required this.mapController,
required this.apiKey,
});
final mgl.MaplibreMapController _raw;
final String _apiKey;
// --- API Integrations ---
// ── Internal object registries ─────────────────────────────
/// Search for places using Intaleq Geocoding API
Future<List<dynamic>> search(String query) async {
final response = await http.get(
Uri.parse('https://map-saas.intaleq.com/v1/geocoding/search?q=$query&key=$apiKey'),
);
if (response.statusCode == 200) {
return json.decode(response.body);
/// Maps our [MarkerId] → the live MapLibre [mgl.Symbol].
final Map<MarkerId, mgl.Symbol> _symbols = {};
/// Reverse map: MapLibre symbol id → our [Marker] (for tap routing).
final Map<String, Marker> _symbolToMarker = {};
/// Maps our [PolylineId] → live MapLibre [mgl.Line].
final Map<PolylineId, mgl.Line> _lines = {};
final Map<String, Polyline> _lineToPolyline = {};
/// Maps our [CircleId] → live MapLibre [mgl.Circle].
final Map<CircleId, mgl.Circle> _circles = {};
/// Maps our [PolygonId] → live MapLibre [mgl.Fill].
final Map<PolygonId, mgl.Fill> _fills = {};
// ── Factory / init ─────────────────────────────────────────
static Future<IntaleqMapController> create({
required mgl.MaplibreMapController raw,
required String apiKey,
}) async {
final ctrl = IntaleqMapController._(raw: raw, apiKey: apiKey);
await ctrl._registerDefaultImages();
return ctrl;
}
/// Pre-loads built-in Intaleq marker images into the map style.
Future<void> _registerDefaultImages() async {
try {
final bytes = await rootBundle
.load('packages/intaleq_maps/assets/markers/default.png');
await _raw.addImage('intaleq-marker-default', bytes.buffer.asUint8List());
} catch (_) {
// Asset not found — developer can register their own via addImage().
}
throw Exception('Failed to search');
}
/// Get route using Intaleq Routing API
Future<Map<String, dynamic>> getRoute(LatLng start, LatLng end, {String profile = 'driving'}) async {
final response = await http.get(
Uri.parse(
'https://map-saas.intaleq.com/v1/routing/route?start=${start.longitude},${start.latitude}&end=${end.longitude},${end.latitude}&profile=$profile&key=$apiKey',
),
);
if (response.statusCode == 200) {
return json.decode(response.body);
// ── Camera (same API as GoogleMapController) ──────────────
/// Animates the camera to the given [update].
Future<bool?> animateCamera(mgl.CameraUpdate update) =>
_raw.animateCamera(update);
/// Instantly moves the camera to the given [update].
Future<bool?> moveCamera(mgl.CameraUpdate update) => _raw.moveCamera(update);
/// Returns the current [mgl.CameraPosition] of the map.
mgl.CameraPosition? get cameraPosition => _raw.cameraPosition;
/// Returns the current zoom level.
Future<double> getZoomLevel() async => _raw.cameraPosition?.zoom ?? 14.0;
/// Returns the [mgl.LatLng] visible at screen coordinate [point].
Future<mgl.LatLng> getLatLng(Point<double> point) =>
_raw.toLatLng(Point(point.x, point.y));
/// Returns the screen coordinate of the given [latLng].
Future<Point<num>> getScreenCoordinate(mgl.LatLng latLng) =>
_raw.toScreenLocation(latLng);
/// Returns the current visible region as [mgl.LatLngBounds].
Future<mgl.LatLngBounds> getVisibleRegion() => _raw.getVisibleRegion();
// ── Map images ─────────────────────────────────────────────
/// Register a custom image into the map.
/// Required before using [InlqBitmap.fromBytes] or custom style images.
Future<void> addImage(String imageId, Uint8List bytes) =>
_raw.addImage(imageId, bytes);
// ── Markers ────────────────────────────────────────────────
/// Adds a single [Marker] to the map and returns its MapLibre handle.
Future<mgl.Symbol> addMarker(Marker marker) async {
await _loadBitmapIfNeeded(marker.icon);
final symbol = await _raw.addSymbol(marker.toSymbolOptions());
_symbols[marker.markerId] = symbol;
_symbolToMarker[symbol.id] = marker;
return symbol;
}
/// Updates an existing marker's position / appearance.
Future<void> _updateMarker(Marker marker) async {
final symbol = _symbols[marker.markerId];
if (symbol == null) return;
await _raw.updateSymbol(symbol, marker.toSymbolOptions());
_symbolToMarker[symbol.id] = marker;
}
/// Removes a marker by its [MarkerId].
Future<void> _removeMarker(MarkerId id) async {
final symbol = _symbols.remove(id);
if (symbol == null) return;
_symbolToMarker.remove(symbol.id);
await _raw.removeSymbol(symbol);
}
// ── Polylines ──────────────────────────────────────────────
Future<mgl.Line> addPolyline(Polyline polyline) async {
final line = await _raw.addLine(polyline.toLineOptions());
_lines[polyline.polylineId] = line;
_lineToPolyline[line.id] = polyline;
return line;
}
Future<void> _updatePolyline(Polyline polyline) async {
final line = _lines[polyline.polylineId];
if (line == null) return;
await _raw.updateLine(line, polyline.toLineOptions());
_lineToPolyline[line.id] = polyline;
}
Future<void> _removePolyline(PolylineId id) async {
final line = _lines.remove(id);
if (line == null) return;
_lineToPolyline.remove(line.id);
await _raw.removeLine(line);
}
// ── Circles ────────────────────────────────────────────────
Future<void> addCircle(Circle circle) async {
final c = await _raw.addCircle(circle.toCircleOptions());
_circles[circle.circleId] = c;
}
Future<void> _updateCircle(Circle circle) async {
final c = _circles[circle.circleId];
if (c == null) return;
await _raw.updateCircle(c, circle.toCircleOptions());
}
Future<void> _removeCircle(CircleId id) async {
final c = _circles.remove(id);
if (c == null) return;
await _raw.removeCircle(c);
}
// ── Polygons ───────────────────────────────────────────────
Future<void> addPolygon(Polygon polygon) async {
final fill = await _raw.addFill(polygon.toFillOptions());
_fills[polygon.polygonId] = fill;
}
Future<void> _updatePolygon(Polygon polygon) async {
final fill = _fills[polygon.polygonId];
if (fill == null) return;
await _raw.updateFill(fill, polygon.toFillOptions());
}
Future<void> _removePolygon(PolygonId id) async {
final fill = _fills.remove(id);
if (fill == null) return;
await _raw.removeFill(fill);
}
// ── Tap routing ────────────────────────────────────────────
void onSymbolTapped(mgl.Symbol symbol) {
final marker = _symbolToMarker[symbol.id];
if (marker == null) return;
marker.onTap?.call();
}
void onLineTapped(mgl.Line line) {
_lineToPolyline[line.id]?.onTap?.call();
}
// ── Diff helpers (called from widget on setState) ──────────
Future<void> diffMarkers(
Set<Marker> oldSet,
Set<Marker> newSet,
) async {
final oldMap = {for (final m in oldSet) m.markerId: m};
final newMap = {for (final m in newSet) m.markerId: m};
// Remove deleted
for (final id in oldMap.keys) {
if (!newMap.containsKey(id)) await _removeMarker(id);
}
throw Exception('Failed to fetch route');
}
// --- Friendly Abstractions (Transformation Layer) ---
/// Add a marker (friendly wrapper for addSymbol)
Future<Symbol> addMarker(MarkerOptions options) async {
return await mapController.addSymbol(options.toSymbolOptions());
}
/// Add multiple markers
Future<List<Symbol>> addMarkers(List<MarkerOptions> optionsList) async {
final symbols = <Symbol>[];
for (var options in optionsList) {
symbols.add(await addMarker(options));
// Add new
for (final entry in newMap.entries) {
if (!oldMap.containsKey(entry.key)) {
await addMarker(entry.value);
} else if (oldMap[entry.key] != entry.value) {
// Update changed (position, icon, etc.)
await _updateMarker(entry.value);
}
}
return symbols;
}
/// Remove a marker
Future<void> removeMarker(Symbol marker) async {
await mapController.removeSymbol(marker);
Future<void> diffPolylines(
Set<Polyline> oldSet,
Set<Polyline> newSet,
) async {
final oldMap = {for (final p in oldSet) p.polylineId: p};
final newMap = {for (final p in newSet) p.polylineId: p};
for (final id in oldMap.keys) {
if (!newMap.containsKey(id)) await _removePolyline(id);
}
for (final entry in newMap.entries) {
if (!oldMap.containsKey(entry.key)) {
await addPolyline(entry.value);
} else if (oldMap[entry.key] != entry.value) {
await _updatePolyline(entry.value);
}
}
}
/// Add a polyline (friendly wrapper for addLine)
Future<Line> addPolyline(PolylineOptions options) async {
return await mapController.addLine(options.toLineOptions());
Future<void> diffCircles(
Set<Circle> oldSet,
Set<Circle> newSet,
) async {
final oldMap = {for (final c in oldSet) c.circleId: c};
final newMap = {for (final c in newSet) c.circleId: c};
for (final id in oldMap.keys) {
if (!newMap.containsKey(id)) await _removeCircle(id);
}
for (final entry in newMap.entries) {
if (!oldMap.containsKey(entry.key)) {
await addCircle(entry.value);
} else if (oldMap[entry.key] != entry.value) {
await _updateCircle(entry.value);
}
}
}
/// Remove a polyline
Future<void> removePolyline(Line polyline) async {
await mapController.removeLine(polyline);
Future<void> diffPolygons(
Set<Polygon> oldSet,
Set<Polygon> newSet,
) async {
final oldMap = {for (final p in oldSet) p.polygonId: p};
final newMap = {for (final p in newSet) p.polygonId: p};
for (final id in oldMap.keys) {
if (!newMap.containsKey(id)) await _removePolygon(id);
}
for (final entry in newMap.entries) {
if (!oldMap.containsKey(entry.key)) {
await addPolygon(entry.value);
} else if (oldMap[entry.key] != entry.value) {
await _updatePolygon(entry.value);
}
}
}
/// Add a circle
Future<Circle> addCircle(CircleOptions options) async {
return await mapController.addCircle(options.toMapLibreOptions());
// ── Clear all ──────────────────────────────────────────────
/// Removes every marker, polyline, circle, and polygon from the map.
Future<void> clearOverlays() async {
await _raw.clearSymbols();
await _raw.clearLines();
await _raw.clearCircles();
await _raw.clearFills();
_symbols.clear();
_symbolToMarker.clear();
_lines.clear();
_lineToPolyline.clear();
_circles.clear();
_fills.clear();
}
/// Remove a circle
Future<void> removeCircle(Circle circle) async {
await mapController.removeCircle(circle);
// ── Intaleq API integrations ───────────────────────────────
/// Searches for places using the Intaleq Geocoding API.
Future<List<dynamic>> searchPlaces(String query) async {
final uri = Uri.https('map-saas.intaleq.com', '/v1/geocoding/search', {
'q': query,
'key': _apiKey,
});
final res = await http.get(uri);
if (res.statusCode == 200) return jsonDecode(res.body) as List<dynamic>;
throw Exception('Geocoding request failed: ${res.statusCode}');
}
/// Add a polygon (Fill)
Future<Fill> addPolygon(PolygonOptions options) async {
return await mapController.addFill(options.toFillOptions());
/// Reverse geocodes a [LatLng] to a place description.
Future<Map<String, dynamic>> reverseGeocode(mgl.LatLng position) async {
final uri = Uri.https('map-saas.intaleq.com', '/v1/geocoding/reverse', {
'lat': position.latitude.toString(),
'lng': position.longitude.toString(),
'key': _apiKey,
});
final res = await http.get(uri);
if (res.statusCode == 200)
return jsonDecode(res.body) as Map<String, dynamic>;
throw Exception('Reverse geocoding failed: ${res.statusCode}');
}
/// Remove a polygon
Future<void> removePolygon(Fill polygon) async {
await mapController.removeFill(polygon);
/// Fetches a route between [origin] and [destination].
///
/// [profile] is one of: `driving`, `cycling`, `walking`.
/// Returns the raw Intaleq Routing API response.
Future<Map<String, dynamic>> getDirections(
mgl.LatLng origin,
mgl.LatLng destination, {
String profile = 'driving',
}) async {
final uri = Uri.https('map-saas.intaleq.com', '/v1/routing/route', {
'start': '${origin.longitude},${origin.latitude}',
'end': '${destination.longitude},${destination.latitude}',
'profile': profile,
'key': _apiKey,
});
final res = await http.get(uri);
if (res.statusCode == 200)
return jsonDecode(res.body) as Map<String, dynamic>;
throw Exception('Routing request failed: ${res.statusCode}');
}
/// Clear all map objects
void clearAll() {
mapController.clearSymbols();
mapController.clearLines();
mapController.clearCircles();
mapController.clearFills();
}
// ── Bitmap loader helper ───────────────────────────────────
// --- Camera Controls ---
final Set<String> _loadedImages = {};
void animateCameraTo(LatLng position, {double? zoom}) {
mapController.animateCamera(CameraUpdate.newLatLngZoom(position, zoom ?? mapController.cameraPosition?.zoom ?? 14.0));
Future<void> _loadBitmapIfNeeded(InlqBitmap bitmap) async {
final id = bitmap.mapLibreImageId;
if (_loadedImages.contains(id)) return;
if (bitmap.bytes != null) {
await _raw.addImage(id, bitmap.bytes!);
_loadedImages.add(id);
} else if (bitmap.assetName != null) {
try {
final data = await rootBundle.load(bitmap.assetName!);
await _raw.addImage(id, data.buffer.asUint8List());
_loadedImages.add(id);
} catch (_) {
// Asset not found — marker will fall back to default.
}
}
// Style-registered images need no loading.
}
}