{"id":15284710,"url":"https://github.com/aliatisoftware/nominatim_location_picker","last_synced_at":"2025-10-23T00:25:36.689Z","repository":{"id":56835469,"uuid":"237113474","full_name":"AliatiSoftware/nominatim_location_picker","owner":"AliatiSoftware","description":"Nominatim has a Completely free geocoding ! Now we have MapBox Support as well","archived":true,"fork":false,"pushed_at":"2020-04-26T13:55:18.000Z","size":65486,"stargazers_count":16,"open_issues_count":9,"forks_count":20,"subscribers_count":2,"default_branch":"master","last_synced_at":"2024-09-30T14:59:23.367Z","etag":null,"topics":["dart","flutter","free","geocoding","google-maps","mapbox","nominatim","openstreetmap"],"latest_commit_sha":null,"homepage":"https://aliatisoftware.com/","language":"Dart","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AliatiSoftware.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-01-30T00:57:13.000Z","updated_at":"2024-08-26T14:07:53.000Z","dependencies_parsed_at":"2022-09-02T03:51:31.534Z","dependency_job_id":null,"html_url":"https://github.com/AliatiSoftware/nominatim_location_picker","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AliatiSoftware%2Fnominatim_location_picker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AliatiSoftware%2Fnominatim_location_picker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AliatiSoftware%2Fnominatim_location_picker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AliatiSoftware%2Fnominatim_location_picker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AliatiSoftware","download_url":"https://codeload.github.com/AliatiSoftware/nominatim_location_picker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":219877435,"owners_count":16554878,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dart","flutter","free","geocoding","google-maps","mapbox","nominatim","openstreetmap"],"created_at":"2024-09-30T14:59:31.042Z","updated_at":"2025-10-07T00:32:15.393Z","avatar_url":"https://github.com/AliatiSoftware.png","language":"Dart","funding_links":["https://www.buymeacoffee.com/6cdltqC"],"categories":[],"sub_categories":[],"readme":"\n# Nominatim Location Picker\n\n\n\n[![pub package](https://img.shields.io/pub/v/nominatim_location_picker.svg)](https://pub.dartlang.org/packages/nominatim_location_picker) [![GitHub stars](https://img.shields.io/github/stars/AliatiSoftware/nominatim_location_picker)](https://github.com/AliatiSoftware/nominatim_location_picker/stargazers) [![GitHub forks](https://img.shields.io/github/forks/AliatiSoftware/nominatim_location_picker)](https://github.com/AliatiSoftware/nominatim_location_picker/network) [![GitHub license](https://img.shields.io/github/license/AliatiSoftware/nominatim_location_picker)](https://github.com/AliatiSoftware/nominatim_location_picker/blob/master/LICENSE) [![GitHub issues](https://img.shields.io/github/issues/AliatiSoftware/nominatim_location_picker)](https://github.com/AliatiSoftware/nominatim_location_picker/issues)\n\nNominatim Location Picker is a package that appears as a **FREE** alternative (WITH NO API KEYS OR EVEN ACCESSTOKEN, NONE OF THEM ARE NECESSARY) with support for Geocoding with a beautiful and coherent interface using the OpenStreetMap Nominatim.\n\n**In the current version, support for Mapbox has also been added**, with an interface in line with  Nominatim so you can choose which one to use or vary between the two of them.\n\n\n\n# Nominatim Location Picker Screenshots\n\n\u003cp\u003e\n\n\u003cimg  src=\"https://github.com/AliatiSoftware/nominatim_location_picker/blob/master/example/assets/screenshot/nominatim.gif?raw=true\"  width=265/\u003e\n\n\u003cimg  src=\"https://github.com/AliatiSoftware/nominatim_location_picker/blob/master/example/assets/screenshot/nominatim-01.png?raw=true\"  width=265  /\u003e\n\n\u003cimg  src=\"https://github.com/AliatiSoftware/nominatim_location_picker/blob/master/example/assets/screenshot/nominatim-02.png?raw=true\"  width=265  /\u003e\n\n\u003cimg  src=\"https://github.com/AliatiSoftware/nominatim_location_picker/blob/master/example/assets/screenshot/nominatim-03.png?raw=true\"  width=265  /\u003e\n\n\u003c/p\u003e\n\n# MapBox Location Picker Screenshots\n\n\u003cp\u003e\n\u003cimg  src=\"https://github.com/AliatiSoftware/nominatim_location_picker/blob/master/example/assets/screenshot/mapbox.gif?raw=true\"  width=265/\u003e\n\n\u003cimg  src=\"https://github.com/AliatiSoftware/nominatim_location_picker/blob/master/example/assets/screenshot/mapbox-01.png?raw=true\"  width=265  /\u003e\n\n\u003cimg  src=\"https://github.com/AliatiSoftware/nominatim_location_picker/blob/master/example/assets/screenshot/mapbox-02.png?raw=true\"  width=265  /\u003e\n\n\u003cimg  src=\"https://github.com/AliatiSoftware/nominatim_location_picker/blob/master/example/assets/screenshot/mapbox-03.png?raw=true\"  width=265  /\u003e\n\n\u003c/p\u003e\n\n\n\n\n# Nominatim Location Picker's version 0.1.0+7 features!\n\n**- Custom Maps and Markers**\n\n**- Support with the same interface for MapBox;**\n\n**- Auto search with MapBox**\n\n**- Geocoding search with Nominatim and Mapbox;**\n\n**- Get Current User Location;**\n\n**- Returns the Latitude and Longitude coordinates of the searched location;**\n\n**- Returns the description of the searched location;**\n\n**- Returns the Country, State, city and district of the searched Location in both Nominatim and MapBox;**\n\n\n\n\n# OpenStreetMap Nominatim\n\n\n\nNominatim (from the Latin, 'by name') is a tool to search OpenStreetMap data\n\nby name and address (geocoding) and to generate synthetic addresses of\n\nOSM points (reverse geocoding). An instance with up-to-date data can be found\n\nat https://nominatim.openstreetmap.org. Nominatim is also used as one of the\n\nsources for the Search box on the OpenStreetMap home page.\n\n\n\n# Nominatim's Documentation\n\n\n\n\nThe documentation of the latest development version is in the\n\n`docs/` subdirectory. A HTML version can be found at\n\nhttps://nominatim.org/release-docs/develop/ .\n\n\n\n# Nominatim's Limitations\n\n\n\n- No heavy uses (an absolute maximum of 1 request per second).\n\n- Provide a valid HTTP Referer or User-Agent identifying the application (stock User-Agents as set by http libraries will not do).\n\n- Clearly display attribution as suitable for your medium.\n\n- Data is provided under the ODbL license which requires to share alike (although small extractions are likely to be covered by fair usage / fair dealing).\n\n\n\n# MapBox\n\nMapbox is a large provider of custom online maps for websites and applications. Since 2010, it has rapidly expanded the niche of custom maps, as a response to the limited choice offered by map providers such as Google Maps.\n\n\n\n# MapBox's Documentation\n\nMapbox APIs are divided into four distinct services: Maps, Navigation, Search, and Accounts. Each of these services has its own overview page in this documentation. These overview pages are divided into the individual APIs that make up the service. The documentation for each API is structured by endpoints. An endpoint is a specific method within an API that performs one action and is located at a specific URL\n\n\n\nhttps://docs.mapbox.com/api/\n\n\n\n\n## Usage\n\n\nTo use this plugin, add `nominatim_location_picker` as a [dependency in your pubspec.yaml file](https://flutter.io/platform-plugins/).\n\n\n\n```yaml\n\ndependencies:\n\nnominatim_location_picker: any # or the latest version on Pub\n\n```\n\nImport the Nominatim Location Picker in your .dart file...\n\n\n\n```dart\n\nimport  'package:nominatim_location_picker/nominatim_location_picker.dart';\n\n```\n\n\n\n### Android Permissions\n\n\nThe following permissions are recommended.\n\n\n\n`android.permission.ACCESS_FINE_LOCATION` Allows the API to determine as precise a location as possible from the available location providers, including the Global Positioning System (GPS) as well as WiFi and mobile cell data.\n\n\n\n`android.permission.ACCESS_COARSE_LOCATION` Allows the API to use WiFi or mobile cell data (or both) to determine the device's location. The API returns the location with an accuracy approximately equivalent to a city block.\n\n\n\n```xml\n\n\u003cuses-permission  android:name=\"android.permission.ACCESS_FINE_LOCATION\"  /\u003e\n\n\u003cuses-permission  android:name=\"android.permission.ACCESS_COARSE_LOCATION\"  /\u003e\n\n\u003cuses-permission  android:name=\"android.permission.INTERNET\"  /\u003e\n\n```\n\n\n### Example of Nominatim Location Picker\n\n[See more in the main.dart file](https://github.com/AliatiSoftware/nominatim_location_picker/blob/master/example/lib/main.dart).\n\n\n\n``` dart\n\nimport  'package:nominatim_location_picker/nominatim_location_picker.dart';\n\n  Future getLocationWithNominatim() async {\n    Map result = await showDialog(\n        context: context,\n        builder: (BuildContext ctx) {\n          return NominatimLocationPicker(\n            searchHint: 'Pesquisar',\n            awaitingForLocation: \"Procurando por sua localização\",\n          );\n        });\n    if (result != null) {\n      setState(() =\u003e _pickedLocation = result);\n    } else {\n      return;\n    }\n  }\n```\n\n\n### Nominatim Location Picker with Custom Maps and Markers\n\n[See more in the main.dart file](https://github.com/AliatiSoftware/nominatim_location_picker/blob/master/example/lib/main.dart).\n\n\n\n``` dart\n\nimport  'package:nominatim_location_picker/nominatim_location_picker.dart';\nimport 'package:flutter_map/flutter_map.dart';\n\n  Future getLocationWithNominatim() async {\n    Map result = await showDialog(\n      context: context,\n      builder: (BuildContext ctx) {\n        return NominatimLocationPicker(\n          searchHint: 'Pesquisar',\n          awaitingForLocation: \"Procurando por sua localização\",\n          customMarkerIcon: Image.asset(\n            \"assets/marker.png\",\n          ),\n          customMapLayer: TileLayerOptions(\n            urlTemplate: \"https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png\",\n            subdomains: ['a', 'b', 'c']\n          ),\n        );\n      }\n    );\n    if (result != null) {\n      setState(() =\u003e _pickedLocation = result);\n    } else {\n      return;\n    }\n  }\n```\n\n\n### Example of MapBox Location Picker\n\n[See more in the main.dart file](https://github.com/AliatiSoftware/nominatim_location_picker/blob/master/example/lib/main.dart).\n\n\n\n``` dart\n\nimport  'package:nominatim_location_picker/nominatim_location_picker.dart';\n\n  Widget getLocationWithMapBox() {\n    return MapBoxLocationPicker(\n      popOnSelect: true,\n      apiKey: \"YOUR API KEY\",\n      limit: 10,\n      language: 'pt',\n      country: 'br',\n      searchHint: 'Pesquisar',\n      awaitingForLocation: \"Procurando por sua localização\",\n      onSelected: (place) {\n        setState(() {\n          _pickedLocationText = place.geometry.coordinates; // Example of how to call the coordinates after using the Mapbox Location Picker\n          print(_pickedLocationText);\n        });\n      },\n      context: context,\n    );\n  }\n```\n\n### MapBox Location Picker with Custom Maps and Markers\n\n[See more in the main.dart file](https://github.com/AliatiSoftware/nominatim_location_picker/blob/master/example/lib/main.dart).\n\n\n\n``` dart\n\nimport  'package:nominatim_location_picker/nominatim_location_picker.dart';\nimport 'package:flutter_map/flutter_map.dart';\n\n  Widget getLocationWithMapBox() {\n    return MapBoxLocationPicker(\n      popOnSelect: true,\n      apiKey: \"YOUR API KEY\",\n      limit: 10,\n      language: 'pt',\n      country: 'br',\n      searchHint: 'Pesquisar',\n      awaitingForLocation: \"Procurando por sua localização\",\n\n      customMarkerIcon: Image.asset(\n        \"assets/marker.png\",\n      ),\n\n      customMapLayer: TileLayerOptions(\n        urlTemplate: \"https://{s}.tile.openstreetmap.org/{z}/{x}/{y}.png\",\n        subdomains: ['a', 'b', 'c']\n      ),\n\n      onSelected: (place) {\n        setState(() {\n          _pickedLocationText = place.geometry\n              .coordinates; // Example of how to call the coordinates after using the Mapbox Location Picker\n          print(_pickedLocationText);\n        });\n      },\n      context: context,\n    );\n  }\n```\n\n\n\n\n#### Aliati Software Development Team\n\n\n\n\n| Team Members | Role | Github | Email|\n| ------ | ------ | ------ | ------ |\n| Lucas Finoti |CEO | [https://github.com/FinotiLucas][LFGh] | lucas.finoti@protonmail.com|\n| João Pedro Martins |CTO | [https://github.com/jpmdodev][JpGh] | jpmdo98@gmail.com|\n\n\n\n\n### Credits\n\n\nEverything that we use as a reference to make this project possible\n\n\n\n| Source | Web Sites |\n| ------ | ------ |\n| Nominatim | [https://nominatim.org/release-docs/develop/][NNT] |\n| Open Street Map | [https://www.openstreetmap.org][OSM] |\n| Wikimedia Maps | [http://wikimapia.org/][WMM] |\n| Google Maps Location Picker | [https://pub.dev/packages/google_map_location_picker][GMLP]\n| Mapbox Search | [https://pub.dev/packages/mapbox_search][MBS]\n\n\n\n\n### Development\n\n\nWant to contribute? Great!\n\nSharing code makes the world a better place \u003c3\n\n\n\n\n### Support\n\n\n\n\nHelp us to continue developing solutions for the community\n\n\n\u003ca  href=\"https://www.buymeacoffee.com/6cdltqC\"  target=\"_blank\"\u003e\u003cimg  src=\"https://cdn.buymeacoffee.com/buttons/default-blue.png\"  alt=\"Buy Me A Coffee\"  style=\"height: 51px !important;width: 217px !important;\"  \u003e\u003c/a\u003e\n\n\n\n\n\n### License\n\n\n\n\nApache License 2.0\n\n\n\nCopyright (c) 2020 Aliati Sotware, Lucas Finoti and João Pedro Martins\n\n\n\n[See more about the license][LICENSE]\n\n\n\n[LFGh]: \u003chttps://github.com/FinotiLucas\u003e\n\n[JPGh]: \u003chttps://github.com/jpmdodev\u003e\n\n[LICENSE]: \u003chttps://github.com/AliatiSoftware/nominatim_location_picker/blob/master/LICENSE\u003e\n\n[GMLP]: \u003chttps://pub.dev/packages/google_map_location_picker\u003e\n\n[MBS]: \u003chttps://pub.dev/packages/mapbox_search\u003e\n\n[NNT]: \u003chttps://nominatim.org/release-docs/develop/\u003e\n\n[OSM]: \u003chttps://www.openstreetmap.org\u003e\n\n[WMM]: \u003chttp://wikimapia.org/\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliatisoftware%2Fnominatim_location_picker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faliatisoftware%2Fnominatim_location_picker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faliatisoftware%2Fnominatim_location_picker/lists"}