Google Apps ScriptでDirectionFinderを使う。
実は、書籍を執筆していて、現在校正作業中のステータスです。（多分、発売は新年あけてからになると思います。）
書籍の中でMapsサービスについても記述しています。
で、時間的リソースの関係でDirectionFinderについての記述ができないと思っていたのですが、
少しだけ書けてしまったので、書籍に書かれていない内容を紹介しようと思います。
DirectionFinder？
DirectionFinderとは、Google Directions APIをラップしたもので
始点と終点を指定して、その間のルート情報を取得するものです。
Directions APIのドキュメント：https://developers.google.com/maps/documentation/directions/
とりあえず、書籍のコードと同等のコード。
function myFunction() {
var finder = Maps.newDirectionFinder();
// 岡山駅からGoogleJapanオフィスまで
finder.setOrigin("岡山駅");
finder.setDestination("六本木ヒルズ");
// 結果の取得
var obj = finder.getDirections();
printResult(obj);
}
function printResult(obj) {
Logger.log("status = %s", obj.status);
Logger.log("summary = %s", obj.routes[0].summary);
Logger.log("bounds = %s", obj.routes[0].bounds);
Logger.log("copyrights = %s", obj.routes[0].copyrights);
Logger.log("waypoint_order = %s", obj.routes[0].waypoint_order);
Logger.log("legs = %s", obj.routes[0].legs);
Logger.log("warnings = %s", obj.routes[0].warnings);
Logger.log("overview_polyline = %s", obj.routes[0].overview_polyline);
}
これは、岡山駅から六本木ヒルズ（Google Japan オフィス）まで行くぜ！と
思った時にどんな道のりになるのかを取得しています。
実行結果
で、取得されるログ（ログウインドウ）ですが、
status = OK
summary = ���������������������
bounds = {southwest={lng=133.88904, lat=34.66627}, northeast={lng=139.72843, lat=35.66176}}
copyrights = Map data ��2012 Google, ZENRIN
waypoint_order = []
legs = [{distance={text=660 km, value=660156}, duration={text=7 hours 56 mins, value=28536}, end_location={lng=139.72843, lat=35.66070000000001}, start_address=Okayama Station, ��� Ekimotomachi, Kita Ward, Okayama, Okayama Prefecture, Japan, end_address=Roppongi Hills, ���������-������ Roppongi, Minato, Tokyo 106-6108, Japan
（以下略）
文字化けしてしまって、ログウインドウでは何が書いてあるのかわかりません…
（書籍に書けなかった事。その１）移動モードを変えてみよう！
移動モードが、Directions APIの初期値のままなので、このルート情報はDriving（車移動）でのルートが出力されています。やっぱり公共交通機関で移動する事が多いでしょうからtransit（公共交通機関）での情報を出力…。したいのですが、なぜか、
Maps.DirectionFinder.Modeには、DRIVING（自動車）、BICYCLING（自転車）、WALKING（歩き）の3つしかありません。補完機能にも出ず、ドキュメントもなく、Stringっぽいので"transit"なんて指定すると、
「無効な引数」…だそうです。
コード
function myFunction() {
var finder = Maps.newDirectionFinder();
// 岡山駅からGoogleJapanオフィスまで
finder.setOrigin("岡山駅");
finder.setDestination("六本木ヒルズ");
// 移動モードの設定
finder.setMode(Maps.DirectionFinder.Mode.WALKING);
// 結果の取得
var obj = finder.getDirections();
printResult(obj);
}
出力結果
（省略）
（書籍に書けなかった事。その２）そうだ！言語設定を変えよう
言語設定のデフォルトは（多分"en"）なので、日本語にしてみようと思います。
function myFunction() {
var finder = Maps.newDirectionFinder();
// 岡山駅からGoogleJapanオフィスまで
finder.setOrigin("岡山駅");
finder.setDestination("六本木ヒルズ");
// 移動モードの設定
finder.setMode(Maps.DirectionFinder.Mode.WALKING);
// 言語設定
finder.setLanguage("ja");
var obj = finder.getDirections();
printResult(obj);
}
実行結果
もっと文字化けがひどくなったので省略（恐らく、日本語情報が増えた）
まとめ
書籍にも書いてあるのですが、ログ出力だと文字化けして日本語の文字が見えない。
他のものに出力したら話は別です。
Maps.DirectionFinder.Mode.TRANSITを増やしてください。なぜ無効な引数なんでしょうか。
と、いったようにいろいろなAPIが実行できるようになっているので
Google Apps Scriptは非常に便利です。