خرائط Flutter بلا إنترنت باستخدام PMTiles
Zusammenfassung
يستعرض إعلان Pixel حزمة pmtiles_provider لعرض خرائط raster بلا إنترنت في flutter_map باستخدام أرشيف PMTiles واحد. تدعم الملفات وassets والذاكرة والاستضافة عبر HTTP range requests، مع تخزين مؤقت وإعدادات من البيانات الوصفية وخيارات للتعامل مع البلاطات المفقودة؛ وهي لا ترسم البلاطات المتجهة.
DEV Community
pmtiles_provider: خرائط raster بلا إنترنت في flutter_map من ملف PMTiles واحد
الخريطة التي تعمل بلا إنترنت (offline) تعني عادةً مجلدًا فيه آلاف الصور الصغيرة (البلاطات، tiles)، أو خادم بلاطات عليك تشغيله. PMTiles فكرة أبسط: الخريطة كلها ملف واحد، في أوله فهرس يقول أين توجد كل بلاطة. القارئ يحتاج فقط الترويسة (header)، وبعض الفهارس (directories)، والبلاطات الظاهرة على الشاشة. والملف نفسه يمكن أن يكون في تخزين الهاتف، أو على استضافة ثابتة عادية يجلب منها القارئ مقاطع من البايتات عبر HTTP. pmtiles_provider تجلب هذا إلى flutter_map. هي TileProvider لأرشيفات PMTiles v3 من نوع raster. تعرض خريطة من ملف واحد بلا إنترنت، من ملف أو asset أو من الذاكرة، أو تبثّها من أي استضافة ثابتة عبر HTTP range requests. شيء يجب قوله من البداية: الحزمة ترسم بلاطات raster فقط (PNG و JPEG و WebP). ليست محرّك رسم للبلاطات المتجهة (vector tiles). فتح أرشيف MVT يفشل بخطأ واضح يوجّهك إلى محرّك vector. ماذا تقدّم أربعة مصادر. PmTilesProvider.fromFile و.fromBytes و.fromAsset و.fromUrl. مع الملفات، القراءة عشوائية (random access): لا يُقرأ إلا الترويسة والفهارس والبلاطات الظاهرة. والوصول إلى الملفات موضوع خلف conditional import، فالحزمة تُبنى للويب أيضًا. طلبات HTTP range مع كشف التغيّر. fromUrl ترسل طلبات Range وتتابع ETag وLast-Modified وحجم الأرشيف. إذا استُبدل الأرشيف على الخادم في منتصف الجلسة، يُكتشف التغيّر، وتُفرَّغ الـ caches، ويُعاد الطلب، ويُطلق provider.changes حدثًا حتى يعيد TileLayer.reset تحميل البلاطات القديمة. الـ caches. هناك LRU cache للفهارس الفرعية (leaf directories) بالعدد، وآخر لبايتات البلاطات بالحجم. الحجمان قابلان للضبط. والترويسة مع الفهرس الجذري تأتيان من قراءة واحدة بحجم 16 KiB. البيانات الوصفية (metadata). provider.info() تعطي حدود الأرشيف، ومركزه، وأدنى وأقصى zoom، ونوع البلاطات، والاسم، والـ attribution. وinfo.mapOptions() تبني MapOptions منها، فتُفتح الخريطة على المكان الصحيح. البلاطات المفقودة. البلاطة المفقودة يمكن أن تكون شفافة، أو خطأ (فتظهر TileLayer.errorImage)، أو overzoom: تُقصّ أقرب بلاطة من مستوى أعلى وتُكبَّر. الـ overzoom يملأ أيضًا مستويات zoom الأعمق من أقصى zoom في الأرشيف. الإلغاء. البلاطة التي تخرج من الشاشة تُلغي قراءتها المعلّقة. والقراءات المشتركة بين عدة بلاطات لا تُلغى إلا إذا ألغت كل البلاطات المنتظرة. قارئ مكتوب من المواصفة. قارئ PMTiles v3 يغطي الترويسة، وفهارس varint و delta، والـ run lengths، والفهارس الفرعية، ومعرّفات Hilbert TileID، وضغط gzip. طريقة الاستعمال أضِفها من GitHub، مع flutter_map و latlong2: dependencies:
flutter_map: ^8.0.0
latlong2: ^0.9.1
pmtiles_provider:
git: https://github.com/AbdeldjalilChougui/pmtiles_provider
ثم أعطِ المزوّد لـ TileLayer: import 'package:flutter/material.dart';
import 'package:flutter_map/flutter_map.dart';
import 'package:pmtiles_provider/pmtiles_provider.dart';
class OfflineMap extends StatefulWidget {
const OfflineMap({super.key, required this.path});
final String path;
@override
State createState() => _OfflineMapState();
}
class _OfflineMapState extends State {
late final provider = PmTilesProvider.fromFile(
widget.path,
missingTile: const MissingTileBehavior.overzoom(),
);
late final info = provider.info();
@override
Widget build(BuildContext context) {
return FutureBuilder(
future: info,
builder: (context, snapshot) {
final info = snapshot.data;
if (info == null) return const SizedBox();
return FlutterMap(
options: info.mapOptions(), // center, zoom, bounds from the archive
children: [
TileLayer(
tileProvider: provider,
reset: provider.changes,
userAgentPackageName: 'com.example.app',
),
],
);
},
);
}
}
المصادر الأخرى تُكتب هكذا: PmTilesProvider.fromUrl('https://cdn.example.com/region.pmtiles');
PmTilesProvider.fromAsset('assets/region.pmtiles'); // loaded into memory
PmTilesProvider.fromBytes(bytes);
كل constructor يقبل أحجام الـ cache: directoryCacheSize: 64 وtileCacheBytes: 8 * 1024 * 1024. يمكنك فحص الأرشيف قبل عرض الخريطة. provider.validate() ترمي PmTilesTileTypeException إذا كان الأرشيف يحت...

Powered by Readybot.io