{"id":21065084,"url":"https://github.com/prolificinteractive/geocoder","last_synced_at":"2025-05-16T02:32:59.663Z","repository":{"id":147516537,"uuid":"131605855","full_name":"prolificinteractive/geocoder","owner":"prolificinteractive","description":"This is a device independent and plugable replacement for Android's builtin Geocoder.","archived":false,"fork":false,"pushed_at":"2018-05-22T21:04:45.000Z","size":181,"stargazers_count":6,"open_issues_count":4,"forks_count":1,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-04-03T19:11:14.477Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Kotlin","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/prolificinteractive.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-04-30T14:28:05.000Z","updated_at":"2022-02-28T05:32:07.000Z","dependencies_parsed_at":null,"dependency_job_id":"85fccd22-f0b8-47c1-a8a3-3d7abb4c67ba","html_url":"https://github.com/prolificinteractive/geocoder","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prolificinteractive%2Fgeocoder","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prolificinteractive%2Fgeocoder/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prolificinteractive%2Fgeocoder/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/prolificinteractive%2Fgeocoder/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/prolificinteractive","download_url":"https://codeload.github.com/prolificinteractive/geocoder/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":254456237,"owners_count":22074133,"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":[],"created_at":"2024-11-19T17:53:27.093Z","updated_at":"2025-05-16T02:32:59.650Z","avatar_url":"https://github.com/prolificinteractive.png","language":"Kotlin","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Geocoder\n\nThis is a device independent and plugable replacement for Android's builtin Geocoder.\n\n\u003e A class for handling geocoding and reverse geocoding. Geocoding is the process of transforming a street address or other description of a location into a (latitude, longitude) coordinate. Reverse geocoding is the process of transforming a (latitude, longitude) coordinate into a (partial) address. The amount of detail in a reverse geocoded location description may vary, for example one might contain the full street address of the closest building, while another might contain only a city name and postal code.\n\n### Why\n\nAndroid's implementation of [Geocoder](https://developer.android.com/reference/android/location/Geocoder.html)\nrequires the a backend service that is not included in the code android framework.\nOn devices where this backend framework is absent, all calls to the Android Geocoder\nwill silently fail. Additionally, the backend implementation of the android Geocoder may\nvary across manufacturers, devices and android versions. This library was created\nto provide a consistent experience across all devices and users.\n\n\n## Installation\n\nStep 1. Add the JitPack repository to your build file\n\n```groovy\nallprojects {\n  repositories {\n    ...\n    maven { url 'https://jitpack.io' }\n  }\n}\n```\n\nStep 2. Add the dependency\n\n```groovy\ndependencies {\n    implementation 'com.github.prolificinteractive.geocoder:geocoder:0.1.0'\n\n    // For Geocoder and Google Maps\n    implementation 'com.github.prolificinteractive.geocoder:geocoder-googlemaps:0.1.0'\n\n    // For Geocoder and OkHttp\n    implementation 'com.github.prolificinteractive.geocoder:geocoder-okhttp:0.1.0'\n\n    // For Geocoder and Open Street Maps\n    implementation 'com.github.prolificinteractive.geocoder:geocoder-openstreetmap:0.1.0'\n}\n```\n\n### Usage\n\n\n\n```\n    geocoder = GeocoderBuilder()\n        .addGeocodingApi(GoogleMaps.create())\n        .setDownloaderFactory(\n            OkHttpFactory(OkHttpClient.Builder().build()))\n        .build()\n\n\n    val addresses: List\u003cAddress\u003e = geocoder\n                                    .getFromLocation(\"1600 amphitheatre parkway\", 1)\n                                    .blockingGet()\n```\n\n### Roadmap\n\nThe pitfalls of the Android Geocoder do not become evident until bad reviews start pouring in.\nIn order for relieve a pain of having to roll your own solution, this project aim to be a drop in\nreplacement for the built in Android Geocoder.\n\n- [ ] Remove RxJava from API in favor of Kotlin coroutines.\n\n- [ ] Match method signature of Android's Geocoder.\n\n- [ ] Use Android Platform Address object\n\n- [ ] Streaming JSON parsing\n\n\n\n## Contributing to Geocoder\n\nTo report a bug or enhancement request, feel free to file an issue under the respective heading.\n\nIf you wish to contribute to the project, fork this repo and submit a pull request. Code contributions should follow the standards specified in the [Prolific Android Style Guide](https://github.com/prolificinteractive/android-code-styles).\n\n## License\n\n![prolific](https://s3.amazonaws.com/prolificsitestaging/logos/Prolific_Logo_Full_Color.png)\n\ngeocoder is Copyright (c) 2018 Prolific Interactive. It may be redistributed under the terms specified in the [LICENSE] file.\n\n[LICENSE]: ./LICENSE\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprolificinteractive%2Fgeocoder","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fprolificinteractive%2Fgeocoder","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fprolificinteractive%2Fgeocoder/lists"}