はじめに
この記事は ZENRIN Maps APIからOAuth認証を使用して地図情報を検索したい人のための記事です
ZENRIN Maps API
無料トライアルページ
2ヶ月間無料で利用できます
利用ツール
ブラウザの拡張機能を使用して地図情報を取得してみます
(今回使用したブラウザはChrome
Talend API Tester
ブラウザに拡張機能をインストールしておきます
OAuth2.0認証の有効化
ウェブコンソールからOAuth2.0認証を有効にする
APIキーとclient_id/client_secretを取得
以下をメモっておきます
- APIキー
- client_id
- client_secret
データ取得の手順
1. OAuth2.0認証 トークン取得
まず、API検索に必要なtokenを取得する
ブラウザで Talend API Tester を開く
認証情報を設定する
左下の鍵マーク"Add Authorization"をクリック
フォームが表示されるので、
メモっておいたclient_idとclient_secretを設定すると、
base64エンコードなどの処理を自動でし、次項の送信パラメータに設定してくれます
必要な送信パラメータを設定する
METHOD:POST
URL:https://test-auth.zmaps-api.com/oauth2/token
HEADERS:
Authorization:(自動入力されているはず ※変更する場合は右の鍵マークをクリック
Content-Type:application/x-www-form-urlencoded
BODY:
grant_type=client_credentials
tokenを取得する
「Send」をクリックすると設定が正しければaccess_tokenを取得できるのでメモっておく
※取得したtokenは1時間有効
2. データ取得
取得したtokenを使用して、APIからデータを取得します
今回は 住所検索 を試します
Talend API Tester に必要項目を設定する
METHOD:POST(GETでも可
URL:https://test-web.zmaps-api.com/search/address
※token取得とドメインが違うので注意
HEADERS:
x-api-key:APIキー
Authorization:Bearer [token]
Content-Type:application/x-www-form-urlencoded
BODY:(APIの種類によって必須項目が異なります)
word:試しに "東京都港区" を
APIにリクエストしデータを取得する
任意のパラメータを設定したら「Send」をクリック
json形式で住所データを取得できます
まとめ
APIで地図情報を検索する流れは、
- まずtokenを取得
- そのtokenを使って地図情報を取得する
次回はPythonを使ってAPIからデータを取得してみようと思います