{"id":28386583,"url":"https://github.com/geocodefarm/geocodefarm-java","last_synced_at":"2025-06-13T01:04:24.152Z","repository":{"id":286314888,"uuid":"961046652","full_name":"geocodefarm/geocodefarm-java","owner":"geocodefarm","description":"Java SDK for the Geocode.Farm API","archived":false,"fork":false,"pushed_at":"2025-04-05T18:07:15.000Z","size":15,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-05-30T19:17:59.667Z","etag":null,"topics":["geocode","geocode-api","geocode-farm","geocodefarm","geocoder-api","geocoder-library","geocoder-provider","geocoding","geocoding-api","geocoding-service","geocoding-services","java","java-geopackage","java-jar-client","java-sdk"],"latest_commit_sha":null,"homepage":"https://geocode.farm","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"unlicense","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/geocodefarm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","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":"2025-04-05T16:30:44.000Z","updated_at":"2025-04-05T20:32:36.000Z","dependencies_parsed_at":"2025-04-05T17:40:33.623Z","dependency_job_id":null,"html_url":"https://github.com/geocodefarm/geocodefarm-java","commit_stats":null,"previous_names":["geocodefarm/geocodefarm-java"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/geocodefarm/geocodefarm-java","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geocodefarm%2Fgeocodefarm-java","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geocodefarm%2Fgeocodefarm-java/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geocodefarm%2Fgeocodefarm-java/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geocodefarm%2Fgeocodefarm-java/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/geocodefarm","download_url":"https://codeload.github.com/geocodefarm/geocodefarm-java/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/geocodefarm%2Fgeocodefarm-java/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259559623,"owners_count":22876494,"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":["geocode","geocode-api","geocode-farm","geocodefarm","geocoder-api","geocoder-library","geocoder-provider","geocoding","geocoding-api","geocoding-service","geocoding-services","java","java-geopackage","java-jar-client","java-sdk"],"created_at":"2025-05-30T15:11:40.604Z","updated_at":"2025-06-13T01:04:24.124Z","avatar_url":"https://github.com/geocodefarm.png","language":"Java","readme":"# Geocode.Farm Java SDK\n\nThe official Java SDK for integrating with the Geocode.Farm API. This SDK provides methods for forward and reverse geocoding, allowing easy access to geolocation data from Geocode.Farm.\n\n## Features\n\n- **Forward Geocoding**: Convert an address into latitude and longitude.\n- **Reverse Geocoding**: Convert latitude and longitude into a human-readable address.\n- **Error Handling**: Handles errors gracefully, returning informative messages for easy debugging.\n\n## Installation\n\nTo use the SDK in your Java project, you can either download the `.jar` file (see Releases) or clone the repository and build it yourself.\n\n### Gradle\n\n```gradle\ndependencies {\n    implementation 'com.geocodefarm:geocodefarm-java:4.0'\n}\n```\n\n### Maven\n\n```xml\n\u003cdependency\u003e\n    \u003cgroupId\u003ecom.geocodefarm\u003c/groupId\u003e\n    \u003cartifactId\u003egeocodefarm-java\u003c/artifactId\u003e\n    \u003cversion\u003e4.0\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\n## Setup\n\n1. Clone the repository:\n    ```bash\n    git clone https://github.com/geocodefarm/geocodefarm-java.git\n    ```\n\n2. Build the SDK (using your preferred method, such as Gradle or Maven).\n\n3. Initialize the GeocodeFarm client with your API key:\n    ```java\n    GeocodeFarm geocodeFarm = new GeocodeFarm(\"your-api-key\");\n    ```\n\n## Usage\n\n### Forward Geocoding\n\nUse the `forward()` method to convert an address into latitude and longitude.\n\n```java\nGeocodeFarm geocodeFarm = new GeocodeFarm(\"your-api-key\");\nGeocodeFarm.GeocodeResponse response = geocodeFarm.forward(\"1600 Pennsylvania Ave NW, Washington, DC\");\n\nif (response.isSuccess()) {\n    System.out.println(\"Latitude: \" + response.getAccuracy());\n    System.out.println(\"Longitude: \" + response.getFullAddress());\n} else {\n    System.out.println(\"Error: \" + response.getError());\n}\n```\n\n### Reverse Geocoding\n\nUse the `reverse()` method to convert latitude and longitude into a human-readable address.\n\n```java\nGeocodeFarm geocodeFarm = new GeocodeFarm(\"your-api-key\");\nGeocodeFarm.GeocodeResponse response = geocodeFarm.reverse(38.8977, -77.0365);\n\nif (response.isSuccess()) {\n    System.out.println(\"Address: \" + response.getFullAddress());\n} else {\n    System.out.println(\"Error: \" + response.getError());\n}\n```\n\n## Contributing\n\nWe are open to contributions! If you find any bugs or would like to add new features, feel free to submit a pull request.\n\n## License\n\nThis project is licensed under the [The Unlicense](http://unlicense.org/).\n\n## Contact\n\nFor support, please reach out to us at [support@geocode.farm](mailto:support@geocode.farm).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeocodefarm%2Fgeocodefarm-java","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fgeocodefarm%2Fgeocodefarm-java","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fgeocodefarm%2Fgeocodefarm-java/lists"}