マルティスープ
Staff Blog

2017.11.25

Google Maps API 用 JAVAライブラリ

みなさん、こんにちは。

Google Maps Geocodeing API や Directions API  などを JAVAで利用する時に便利なライブラリがあるのはご存知ですか？

実は、Google社から GitHubで公開されています！

https://github.com/googlemaps/google-maps-services-java

今回は、こちらのライブラリの使い方を解説していきたいと思います。

対象となるAPIは以下の7個になります。

上記ライブラリを JAVA で利用するために、Maven または Gradle でライブラリを読み込む設定を行います。最新のバージョンは「0.2.5」のようです。

MAVENの場合

<dependency>
    <groupId>com.google.maps</groupId>
    <artifactId>google-maps-services</artifactId>
    <version>0.2.5</version>
</dependency>
<dependency>
    <groupId>org.slf4j</groupId>
    <artifactId>slf4j-nop</artifactId>
    <version>1.7.25</version>
</dependency>

Gradle の場合

repositories {
    mavenCentral()
}
dependencies {
    compile 'com.google.maps:google-maps-services:0.2.5'
    compile 'org.slf4j:slf4j-nop:1.7.25'
}

では、実際のプログラム方法を解説します。

まず最初に認証を行い、 GeoApiContext を生成します。この処理は、各APIで共通となります。

GeoApiContext の生成

//APIキーを使用する場合（スタンダードプラン用）
GeoApiContext context = new GeoApiContext.Builder()
    .apiKey({API_KEY}).build();
//クライアントIDとクリプトキーを使用する場合（プレミアムプラン用）
GeoApiContext context = new GeoApiContext.Builder()
    .enterpriseCredentials({クライアントID},  {クリプトキー}).build();

Geocoding API

GeocodingResult[] results = GeocodingApi.geocode(context, "東京都千代田区神田錦町3-11").await();

Directions API

LatLng origin= new LatLng(35.6, 139.6);
LatLng destination = new LatLng(35.7, 139.7);

DirectionsResult result = DirectionsApi.newRequest(context)
    .origin(origin)
    .destination(destination)
    .mode(TravelMode.DRIVING)
    .await();

Distance Matrix API

LatLng[] origins = new LatLng[2];
origins[0] = new LatLng(35.7, 139.7);
origins[1] = new LatLng(35.6, 136.6);

LatLng[] destinations = new com.google.maps.model.LatLng[2];
destinations [0] = new LatLng(35.8, 139.8);
destinations [1] = new LatLng(35.9, 136.9);

DistanceMatrix result = DistanceMatrixApi.newRequest(context)
    .origins(origins)
    .destinations(destinations)
    .mode(TravelMode.DRIVING)
    .await();

いかがでしょうか？

このように簡単なプログラムで 各 API を実行することができますので、私もよく利用しています！

ライブラリのクラスリファレンス 

ライブラリはその他にも、Python、Node.js、Go 言語用もあります。以下のサイトでご確認ください。

https://github.com/googlemaps

ではまた～。