arbitur/Geocoding-Android

Java wrapper for Google's Geocoding API for Android

Download

Step 1. Add the JitPack repository to your build file

Add it in your root settings.gradle at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url 'https://jitpack.io' }
		}
	}

Add it in your settings.gradle.kts at the end of repositories:

	dependencyResolutionManagement {
		repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
		repositories {
			mavenCentral()
			maven { url = uri("https://jitpack.io") }
		}
	}

Add to pom.xml

	<repositories>
		<repository>
		    <id>jitpack.io</id>
		    <url>https://jitpack.io</url>
		</repository>
	</repositories>

Add it in your build.sbt at the end of resolvers:

 
    resolvers += "jitpack" at "https://jitpack.io"

Add it in your project.clj at the end of repositories:

 
    :repositories [["jitpack" "https://jitpack.io"]]

Step 2. Add the dependency

	dependencies {
		implementation 'com.github.arbitur:geocoding-android:1.2.0'
	}

	dependencies {
		implementation("com.github.arbitur:geocoding-android:1.2.0")
	}

	<dependency>
	    <groupId>com.github.arbitur</groupId>
	    <artifactId>geocoding-android</artifactId>
	    <version>1.2.0</version>
	</dependency>


                            
    libraryDependencies += "com.github.arbitur" % "geocoding-android" % "1.2.0"


                            
    :dependencies [[com.github.arbitur/geocoding-android "1.2.0"]]

Readme

Geocoding-Android

This is a Java wrapper for Google's Geocoding Web API

Install

Root build.gradle

allprojects {
	repositories {
		maven { url 'https://jitpack.io' }
	}
}

Module build.gradle

dependencies {
	implementation 'com.github.arbitur:Geocoding-Android:<version>'
}

Usage

Geocoding (Query search)

new Geocoding(query, apiKey /* or null */)
    .setLanguage(language)
    .setBounds(new Bounds(sw, ne))
    .setRegion(region)
    .addComponent(type, value)
    ...
    .fetch(...);

Reverse Geocoding (Coordinate search)

new ReverseGeocoding(coordinate, apiKey /* or null */)
    .setLanguage(language)
    .setResultTypes(resultType1, resultType2 ...)
    .setLocationTypes(locationType1, locationType2 ...)
    .isSensor(isSensor)
    .fetch(...);

Reverse Geocoding (Place ID search)

new ReverseGeocoding(placeId, apiKey /* or null */)
    .setLanguage(language)
    .fetch(...);

Examples

new Geocoding("Stockholm", key) // City
    .setLanguage("sv")
    .setRegion("se")
    .addComponent(AddressTypes.COUNTRY, "Sweden")
    .fetch(...);
    

new Geocoding("Humlegården", key) // Park
    .setLanguage("sv")
    .addComponent(AddressTypes.ADMINISTRATIVE_AREA_LEVEL_1, "Stockholm")
    .fetch(...);
    

new Geocoding("Östermalmstorg 1, Stockholm, Sweden", key) // Street Address
    .setLanguage("sv")
    .setBounds(new Bounds(59.3, 18.01, 59.354, 18.116))
    .fetch(...);


new ReverseGeocoding(59.336, 18.079, apiKey)
    .setLanguage("sv")
    .setResultTypes(AdressTypes.STREET_ADDRESS)
    .setLocationTypes(LocationTypes.ROOF_TOP)
    .isSensor(true)
    .fetch(...);

Fetching

...
.fetch(new Callback() {
    @Override
    public void onResponse(Response response) {
        for (Result result : response.getResults()) {
            Log.d(TAG, result.getFormattedAddress());
            
            addMarkerTo(result.getGeometry().getLocation())
        }
        
        Result[] addresses = response.getResults(AddressTypes.STREET_ADDRESS);
        Result[] routes = response.getResults(AddressTypes.ROUTE);
        
        ...
    }
        
    @Override
    public void onFailed(Response response, IOException exception) {
        Log.d(TAG, "Something went wrong");
    }
})