Skip to main content
Apple Maps Java is published to Maven Central. No extra repository configuration is needed for stable releases.

​
Requirements

  • Java 17 or later. The library targets Java 17 classfiles. It works on any JDK from 17 onward, including JDK 21 and JDK 25.
  • Apple Developer Program membership. Required to create a Maps Identifier, generate a private key, and obtain an authorization token. Membership costs $99/year and grants access to all Apple ecosystem developer resources.

​
Stable release

The current stable version is 0.1.5. 
dependencies {
    implementation("com.williamcallahan:apple-maps-java:0.1.5")
}
Maven Central is included in the default Gradle repository list, so no repositories block change is needed if you already have mavenCentral().

​
Snapshot builds

Snapshot builds track the latest unreleased development work. The current snapshot version is 0.1.6-SNAPSHOT. Snapshots are published to the Sonatype snapshot repository at: 
https://central.sonatype.com/repository/maven-snapshots/
This repository is separate from Maven Central and must be added explicitly. 
repositories {
    mavenCentral()
    maven { url "https://central.sonatype.com/repository/maven-snapshots/" }
}

dependencies {
    implementation("com.williamcallahan:apple-maps-java:0.1.6-SNAPSHOT")
}
Snapshot builds may contain breaking changes and are not recommended for production use.

​
Transitive dependencies

Apple Maps Java depends on:
  • Jackson (tools.jackson:jackson-bom:3.0.4) for JSON serialization and deserialization
  • java.net.http.HttpClient (part of the JDK standard library since Java 11)
No other runtime dependencies are required.

​
Kotlin/JVM

Apple Maps Java works from Kotlin code running on the JVM like any other Maven/Gradle dependency. Kotlin Multiplatform and iOS (Kotlin/Native) are not supported — see Introduction for details.

​
Next step

Quickstart

Make your first geocode call.