Skip to main content
Apple Maps Java is an unofficial Java SDK for the Apple Maps Server API. Add geocoding, place search, autocomplete, routing, and ETA to any JVM application with a few lines of code.

Quickstart

Get your first geocode result in under 5 minutes

Installation

Add the dependency via Gradle or Maven

Authorization

Create your Apple Maps token and configure the SDK

API Overview

Explore every method on the AppleMaps client

​
What you can build

Geocoding

Convert addresses to coordinates and back

Search & Autocomplete

Find businesses and POIs with typeahead support

Directions & ETA

Route between two points and estimate travel time

​
Get started

1

Add the dependency

Add com.williamcallahan:apple-maps-java:0.1.5 to your Gradle or Maven project.
2

Create an Apple Maps token

Sign in to the Apple Developer portal, create a Maps Identifier and private key, and generate a long-lived JWT.
3

Initialize the client

AppleMaps api = new AppleMaps(System.getenv("APPLE_MAPS_TOKEN"));
4

Make your first call

PlaceResults results = api.geocode(
    GeocodeInput.builder("880 Harrison St, San Francisco, CA 94107").build()
);
System.out.println(results);
This SDK targets the Apple Maps Server API — a REST HTTP API for backend services. It does not wrap MapKit (iOS/macOS native UI) or MapKit JS (browser UI).