Merge branch 'master' of https://github.com/sebastianbaar/cordova-plu…

…gin-nativegeocoder

.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,28 @@
+---
+name: Bug report
+about: Create a report to help us improve
+
+---
+
+**Describe the bug**
+A clear and concise description of what the bug is.
+
+**To Reproduce**
+Steps to reproduce the behavior:
+1. Go to '...'
+2. Click on '....'
+3. Scroll down to '....'
+4. See error
+
+**Expected behavior**
+A clear and concise description of what you expected to happen.
+
+**Plugin Version**
+vX.X.X
+
+**Smartphone (please complete the following information):**
+ - Device: [e.g. iPhone6] or Emulator: [e.g. Nexus 7]
+ - OS: [e.g. iOS8.1]
+
+**Additional context**
+Add any other context about the problem here.

.github/ISSUE_TEMPLATE/feature_request.md

@@ -0,0 +1,17 @@
+---
+name: Feature request
+about: Suggest an idea for this project
+
+---
+
+**Is your feature request related to a problem? Please describe.**
+A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+
+**Describe the solution you'd like**
+A clear and concise description of what you want to happen.
+
+**Describe alternatives you've considered**
+A clear and concise description of any alternative solutions or features you've considered.
+
+**Additional context**
+Add any other context or screenshots about the feature request here.

README.md

@@ -3,7 +3,11 @@ Call `nativegeocoder.reverseGeocode()` to transform a latitude and longitude int
 
 > No need for creating API keys or querying external APIs
 
-**This plugin is also available for [Ionic Native](https://ionicframework.com/docs/native/native-geocoder/)**
+
+**Please read [Known Issues](#known-issues) before posting an issue! Thank you!** :heart_eyes:
+
+
+This plugin is also available for **[Ionic Native](https://ionicframework.com/docs/native/native-geocoder/)**.
 
 ## Installation
 ```
@@ -113,3 +117,25 @@ function failure(err) {
   console.log(err);
 }
 ```
+
+## Known Issues
+
+### Android 
+
+#### Geocoder not working
+Errors like `Geocoder is not present on this device/emulator.`, `Geocoder [...] Error` or `Geocoder Service not available`.
+
+**Why?**: 
+The plugin checks for `Geocoder.isPresent()` ([Android docs](https://developer.android.com/reference/android/location/Geocoder.html#isPresent())). One reason for Geocoder not working on a device could be that you are running your app on an emulator or on a device without Google Play Services. But Geocoder API "[...] requires a backend service that is not included in the core android framework".
+
+**Any workaround?**: 
+Yes. Query [Google Maps Geocoding API](https://developers.google.com/maps/documentation/geocoding/start) as a backup if Geocoder is not present.
+
+**Can the plugin handle this?**: 
+No. I decided not to implement Google Maps Geocoding API as a backup because you have to add an [API key and more](https://developers.google.com/maps/documentation/geocoding/usage-and-billing). I want this plugin to remain as small and lightweight as possible.
+
+### iOS
+...
+
+## Thank you :heart:
+Yes you! Thank you very much for using cordova-plugin-nativegeocoder. If you have any feedback or run into issues using the plugin, please file an [issue](https://github.com/sebastianbaar/cordova-plugin-nativegeocoder/issues/new) on this repository.