Paketdetailsv0.0.1+2

flutter_nominatim

Ein Flutter-Plugin für kostenlose Geokodierung und Ortsuche mit dem Nominatim-Service von OpenStreetMap mit integrierten Optimierungen und ohne API-Schlüssel erforderlich

AndroidiOSWebmacOSWindowsLinux

pub.dev API-Dokumentation Quellcode

30-Tage-Downloads: 13
Likes: 21
Pub-Punkte: 150

Paket installieren

flutter pub add flutter_nominatim

Paketübersicht

Aus öffentlichen Paketdaten erstellte Orientierung.

flutter_nominatim ist ein Flutter-Plugin, das kostenlose Geokodierung und Ortsuche mithilfe des Nominatim-Dienstes von OpenStreetMap ermöglicht. Es bietet eingebaute Optimierungen für Leistung und Zuverlässigkeit ohne die Notwendigkeit eines API-Schlüssels. Das Plugin unterstützt mehrere Plattformen wie Android, iOS, Web, macOS, Windows und Linux und ist daher ideal für plattformübergreifende Anwendungen, die Adressensuche und Standortdienste benötigen. Es vereinfacht die Integration mit intuitiven Methoden zur Suche und Abruf von geografischen Daten.

Anwendungsfälle

Adressensuche in Apps
Geokodierung der Benutzereingabe
Ort-Vervollständigung
Standortbasierte Dienste
Kartenpin-Platzierung
Standortabfrage, die offline funktioniert

Hauptmerkmale

Kein API-Schlüssel erforderlich
Eingebaute Anfrageoptimierungen
Plattformübergreifende Unterstützung
Einfache API-Schnittstelle
Echtzeit-Vorschläge für Orte
Angetrieben von OpenStreetMap

Geeignet für

Entwickler, die kostenlose Geokodierung suchen
Apps, die eine Orts-Suchfunktion benötigen
Projekte, die Drittanbieter-API-Kosten vermeiden
Plattformübergreifende Standortfunktionen
Prototyping von ortsbasierten Apps

Hinweise

Rate Limiting durch Nominatim
Abhängig von der Qualität der OpenStreetMap-Daten
Nicht geeignet für den Einsatz in der Hochvolumenproduktion
Beschränkt auf öffentliche Nominatim-Instanz
Benötigt Internetverbindung
Mögliche Verzögerungen während der Spitzenbelastung

Original-README

Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.

flutter_nominatim

Completely Free & Open Source! Unlike other geocoding services, Nominatim is 100% free to use with NO API key required. You can start implementing location features in your app immediately without any payment or API key setup.

Example Screenshots 📸

Place Search	Convert LatLng to Address	Convert Address to LatLng

Auto-complete search with realtime results	Convert coordinates to human-readable address	Convert address to geographical coordinates

Key Benefits

Feature	Description	Benefit
💰 Free Forever	No API key, no pricing tiers	Save hundreds of dollars compared to paid geocoding services
🔑 No Authentication	No API keys or tokens needed	Quick implementation without setup hassle
🌍 Global Coverage	Worldwide address database	Works everywhere your app does
🚀 Easy Integration	Simple API methods	Get started in minutes
⚡ Performance Optimized	Built-in rate limiting & caching	Smooth user experience

Features Overview

1. Place Search 🔍

Auto-complete with debouncing
Real-time results as you type
Most relevant matches
Rich place details
Polygon Boundaries for places

2. Geocoding Services

Service	Description	Example
Forward Geocoding	Convert address to coordinates	"London Bridge" → (51.5074, -0.1278)
Reverse Geocoding	Convert coordinates to address	(51.5074, -0.1278) → "London Bridge, London, UK"

3. Built-in Optimizations

Automatic request debouncing
Rate limit handling
Error management
Input validation

Quick Start

Installation

dependencies:
  flutter_nominatim: ^1.0.0

Basic Usage

// Initialize
final nominatim = Nominatim.instance;

// Search places
final results = await nominatim.search("London");

// Get address from coordinates
final address = await nominatim.getAddressFromLatLng(51.5074, -0.1278);

// Get coordinates from address
final coordinates = await nominatim.getLatLngFromAddress("London Bridge");

Implementation Examples

Auto-complete Search Widget

TextField(
  controller: searchController,
  decoration: const InputDecoration(
    hintText: 'Search places...',
    prefixIcon: Icon(Icons.search),
  ),
  onChanged: (query) {
    if (query.length >= 3) {
      nominatim.search(query).then((results) {
        // Handle results
      });
    }
  },
)