ここから本文です

【アプリ開発者向け】 Yahoo!カーナビの「URLスキーム」を公開!

[お知らせ]  2015年2月2日

【ブログの情報更新】
・パラメータに「name」を追加しました。(2015/2/3追記)
・パラメータに「referer」を追加しました。(2018/11/28追記)
・パラメータに「point」を追加しました。(2020/6/11追記)


いつもYahoo!カーナビをご利用いただきありがとうございます。今回は、アプリ開発などに携わる方々に向けた情報をお知らせします。

早いものでYahoo!カーナビが公開されてから半年。アプリリリース以降も私たち開発スタッフは、日々、新機能の開発や改善に取り組んでいます。

先日、アプリを運営される方からこんな声をいただきました。
『自分の提供するアプリからYahoo!カーナビを起動して、目的地までの経路検索をしたい。』
他のアプリをご利用中にも、Yahoo!カーナビを便利に使っていただけたら……開発スタッフとして、こんなにうれしいことはありません。

このたび、多くのアプリ運営者からのご要望にお応えして、Yahoo!カーナビの「URLスキーム」の仕様を一部公開いたしました!

できること

今いる場所から、目的地までのルート検索ができます。

技術仕様

目的地の緯度と経度を指定してください。

サンプル
yjcarnavi://navi/select?lat=35.6815038&lon=139.766874&name=%E6%9D%B1%E4%BA%AC%E9%A7%85

yjcarnavi://navi/select?point=current&point=35.6284756,139.736571,&point=35.7141672,139.7774091,&point=35.7295071,139.7087114,&point=35.689611,139.6983826,

パラメータ
パラメータ名 パラメータ値
lat緯度(※1)
lon経度(※1)
name目的地名称(※2)
referer遷移元の識別子(map|news など)
point複数指定の場合の地点
・1点のみ指定した場合
 出発地:現在地・目的地:指定した緯度経度 でルート選択画面を表示。
・2点指定した場合
 出発地:1点目に指定した緯度経度・目的地:2点目で指定された緯度経度 でルート選択画面を表示。
・3〜5点指定した場合
 出発地:1点目に指定した緯度経度・経由地:2〜最後から1つ前の点に指定した緯度経度・目的地:最後に指定された緯度経度 でルート選択画面を表示。

・現在地を指定する場合はcurrent。
・緯度,経度,名称は半角カンマで区切る。
・名称の中に半角カンマを入れることができる。
・名称は省略可能で、"緯度,経度"と"緯度,経度,"は同じとみなす。
・名称を省略された場合の挙動はnameパラメータを指定しない場合に準じる。

※1)緯度経度の測地系は世界測地系となります。フォーマットはDEG (Degree)のみサポートしています。
※2)目的地名称は、UTF-8で変換した値を設定してください。

他のアプリからの呼び出し事例

例:他のアプリとして「Yahoo! MAP」を使用
1.Yahoo! MAPで「東京駅」を検索して、吹き出しの青いアイコンをタップ。
2.ルート選択で「車ルート」を選択して、右下の「出発する」をタップ。


3.「Yahoo!カーナビ」が起動して、東京駅までのルートを表示します。


この「URLスキーム」をご利用いただくと、他のアプリからでも簡単に目的地までのルートや移動時間が分かります。アプリの開発などにぜひご活用ください。

【利用上のご注意】
URLスキームをご利用いただく際は、「Yahoo!カーナビ」アプリをインストールしてください。アプリが入っていない場合は、スキームが起動しませんのでご注意ください。

Yahoo!カーナビは、今後も他のアプリとの連携を増やし、便利にご利用いただけるよう改善をすすめて参ります。これからもYahoo!カーナビをよろしくお願いいたします。
(文:齋藤)

※実際の交通ルールに従って運転してください。
※運転中の操作および画面注視は大変危険ですのでおやめください。
※必ず安全な場所に停止してから操作および画面を注視してください。

※アプリケーションはiPhone、iPadでご利用いただけます。
※iPhone、iPadはApple Inc.の商標です。
※iPhone商標は、アイホン株式会社のライセンスに基づき使用されています。
※Copyright (C) 2015 Apple Inc. All rights reserved.
※アプリケーションはAndroidでご利用いただけます。



■Yahoo!カーナビを初めてご利用の方に Yahoo!カーナビ「かんたんガイド」
■おすすめの記事

アーカイブ