Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/woheller69/omgeodialog
Android DialogFragment for search via Open-Meteo geocoding API
https://github.com/woheller69/omgeodialog
Last synced: about 1 month ago
JSON representation
Android DialogFragment for search via Open-Meteo geocoding API
- Host: GitHub
- URL: https://github.com/woheller69/omgeodialog
- Owner: woheller69
- License: gpl-3.0
- Created: 2023-05-08T11:00:36.000Z (over 1 year ago)
- Default Branch: master
- Last Pushed: 2023-10-12T08:55:54.000Z (about 1 year ago)
- Last Synced: 2023-10-13T02:48:23.173Z (about 1 year ago)
- Language: Java
- Homepage:
- Size: 753 KB
- Stars: 0
- Watchers: 2
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# OmGeoDialog
### Overview
This library contains an Android DialogFragment for search-as-you-type via the Open-Meteo geocoding API.
(see https://open-meteo.com/en/docs/geocoding-api)
You can type an address and get the coordinates back. The result will be shown on a map.
### Installation
Add the JitPack repository to your root build.gradle at the end of repositories:
```gradle
allprojects {
repositories {
...
maven { url 'https://jitpack.io' }
}
}
```
Add the library dependency to your build.gradle file.
```gradle
dependencies {
implementation 'com.github.woheller69:OmGeoDialog:V1.5'
}
```
### Usage
Let your activity implement OmGeoDialog.OmGeoDialogResult
```
public class MainActivity extends AppCompatActivity implements OmGeoDialog.OmGeoDialogResult
```
and override onOmGeoDialogResult, where you define what to do with the result
```
@Override
public void onOmGeoDialogResult(City city) {
String cityName = city.getCityName();
String countryCode = city.getCountryCode();
float lon = city.getLongitude();
float lat = city.getLatitude();
// do what you need to do
}
```
Open a search dialog:
```
FragmentManager fragmentManager = getSupportFragmentManager();
OmGeoDialog omGeoDialog = new OmGeoDialog();
omGeoDialog.setTitle("Search");
omGeoDialog.setNegativeButtonText("Cancel");
omGeoDialog.setPositiveButtonText("Select");
//Optional: Define countries. Otherwise locations in all countries are shown
ArrayList countryList = new ArrayList<>();
countryList.add("DE");
countryList.add("AT");
omGeoDialog.setCountryList(countryList);
//Optional: Define User-Agent
omGeoDialog.setUserAgentString(BuildConfig.APPLICATION_ID+"/"+BuildConfig.VERSION_NAME);
omGeoDialog.show(fragmentManager, "");
getSupportFragmentManager().executePendingTransactions();
```
### License
This library is licensed under the GPLv3.
The library uses:
- Leaflet which is licensed under the very permissive 2-clause BSD License
- Map data from OpenStreetMap, licensed under the Open Data Commons Open Database License (ODbL) by the OpenStreetMap Foundation (OSMF) (https://www.openstreetmap.org/copyright)
- Search-as-you-type location search is provided by [Open-Meteo.com](https://open-meteo.com/en/docs/geocoding-api)
- Android Volley (com.android.volley) (https://github.com/google/volley) which is licensed under Apache License Version 2.0
- AndroidX libraries (https://github.com/androidx/androidx) which is licensed under Apache License Version 2.0
- AutoSuggestTextViewAPICall (https://github.com/Truiton/AutoSuggestTextViewAPICall) which is licensed under Apache License Version 2.0