套件詳情v0.0.1+2

flutter_nominatim

一個用於免費地理編碼和地點搜尋的 Flutter 外掛程式，使用 OpenStreetMap 的 Nominatim 服務，內建優化且不需要 API 金鑰

AndroidiOSWebmacOSWindowsLinux

pub.dev API 文件原始碼

近 30 天下載: 13
喜歡數: 21
Pub 分數: 150

安裝套件

flutter pub add flutter_nominatim

套件介紹

根據套件公開資料產生的選型評估，僅供參考。

flutter_nominatim 是一個 Flutter 插件，可使用 OpenStreetMap 的 Nominatim 服務實現免費的地點編碼與搜尋。它提供內建的效能與可靠性優化，無需 API 金鑰。此插件支援多個平台，包括 Android、iOS、Web、macOS、Windows 與 Linux，非常適合需要地址查詢與定位服務的跨平台應用。它透過直覺的方法簡化地理資料的搜尋與取得整合。

適用情境

應用中的地址搜尋
地理編碼使用者輸入
位置自動補全
基於位置的服務
地圖標記放置
離線可用的位置查詢

主要特色

不需要 API 金鑰
內建請求優化
跨平台支援
簡單 API 界面
即時地點建議
基於OpenStreetMap

適合對象

尋求免費地理編碼的開發者
需要地點搜尋功能的應用
專案避免第三方API成本
跨平台位置功能
原型設計基於位置的應用程式

使用建議

Nominatim 的速率限制
依賴於 OpenStreetMap 資料品質
不適合高體積生產環境使用
僅限公開的 Nominatim 實例
需要互聯網連接
高峰使用期間可能出現延遲

原始 README

以下為關聯原始碼儲存庫的 README 原文快照，最新內容請造訪原始碼儲存庫。

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