【初心者向けGAS】天気予報APIからのJSONをオブジェクトに変換する方法

Google Apps Script

photo credit: faungg's photos Central Park, NYC via photopin (license)

2019.07.312019.10.31

photo credit: faungg’s photos Central Park, NYC via photopin (license)

みなさん、こんにちは！
タカハシ(@ntakahashi0505)です。

初心者ノンプログラマー向けとして「GASを使ってSlackにメッセージを送る」を目標に連載をお送りしております。

前回の記事はこちら。

【初心者向けGAS】SlackアプリのIncoming Webhooksを使ってメッセージを投稿する方法

初心者ノンプログラマー向けとして「GASを使ってSlackにメッセージを送る」を目標に連載をお送りしております。今回はSlackアプリのIncoming Webhooksを使ってメッセージを投稿する方法です。

GASでスクリプトを書いて、Slackにメッセージを送ることができました。

さて、このシリーズではSlackに天気予報の結果を送りたいので、それに向けて進めていきましょう。

まずは、天気予報の情報を取得するAPI「Weather Hacks」とそのレスポンスをオブジェクトに変換する方法を紹介します。

では、行ってみましょう！

天気予報API「Weather Hacks」
1. Weather HacksのリクエストURL
レスポンスからオブジェクトを取り出す
1. HTTPレスポンスの内容をログで確認する
2. JSON文字列をオブジェクトに変換する
まとめ
連載目次：はじめてのSlackアプリでメッセージを投稿する

天気予報API「Weather Hacks」

さて、天気予報といってもどこからその情報を取得すればよいでしょうか？

そんな時に、使えるのも「API」です。

Weather Hacksという無料で使用できる天気予報APIがありますので、これを使っていきましょう。

livedoor for スマートフォン

株式会社ライブドアが運営するポータルサイト。日本最大級のブログサービス「livedoor blog」、独自の切り口を誇るニュースサイト「livedoor ニュース」など幅広いサービスを展開、厳選した情報を毎日お届けします。

Slack APIのIncoming Webhookでは、決められたURLにPOSTリクエストをすればSlackへの投稿ができました。

Weather Hacksでは、決められたURLにGETリクエストをすることで、天気予報のデータを取得できるのです。

Weather HacksのリクエストURL

Weather HacksのリクエストURLは以下のような形式です。

http://weather.livedoor.com/forecast/webservice/json/v1?city=130010

「130010」の6桁の番号はCityIDというもので都市ごとに振られています。この番号は東京のもので、東京の現時点の天気予報の情報を取得することができます。

各地域のCityIDは以下のページで調べることができます。

livedoor

株式会社ライブドアが運営するポータルサイト。速報性に加え独自の切り口を誇る「ライブドアニュース」、日本最大のブログサービス「ライブドアブログ」ほか、厳選した情報をお届けします。

レスポンスからオブジェクトを取り出す

HTTPレスポンスの内容をログで確認する

Weather HacksではHTTPリクエストの結果として、HTTPレスポンスを受け取れます。

GASでは、fetchメソッドの戻り値がHTTPレスポンスを表す、HTTPResponseオブジェクトとなります。

そこから、内容を取り出すのがgetContentTextメソッドです。

HTTPResponseオブジェクト.getContentText()

では、試しにWeather Hacksへリクエストをして、レスポンスの内容をログ確認してみましょうか。

function test() {
  
  var url = 'http://weather.livedoor.com/forecast/webservice/json/v1?city=130010'; //URL+cityID
  var res = UrlFetchApp.fetch(url);
  Logger.log(res);

}

GETリクエストなのでfetchメソッドの引数はURL文字列を与えるだけでOKです。

実行して、ログを表示してみると…

なんじゃこりゃ…いろいろとそれっぽいデータは含まれているように見えますが…

これは、以下が原因です。

レスポンスはJSON形式の文字列であり
ログの２バイト文字は「uXXXX」のUnicode文字で出力されている

レスポンスの内容をGASで取り扱えるようにするためには、もうひと工夫必要なわけですね。

JSON文字列をオブジェクトに変換する

HTTPレスポンスからgetContentTextメソッドで取り出したものは、JSONという形式の文字列です。

JSONは「JavaScript Object Notation」の略で、和風に言うと「JavaScriptのオブジェクト表記」ということです。

つまり、JavaScriptのオブジェクトに近い表現てことですね。

なので、JSON形式の文字列をJavaScriptのオブジェクトに変換してくれる便利なメソッドが存在しているのです。

それがJSONオブジェクトのparseメソッドです。

では、これを用いてスクリプトを書き直してみましょう。

JSON.parse(文字列)

function test() {
  
  var url = 'http://weather.livedoor.com/forecast/webservice/json/v1?city=130010'; //URL+cityID
  var res = UrlFetchApp.fetch(url);
  var object = JSON.parse(res.getContentText()); 
  Logger.log(object);

}

レスポンスの内容を、parseメソッドでオブジェクト化して、それをobjectという変数に格納、それをログ出力します。

ログ表示はこちらです。