この記事では、Python で JSON形式データの取り扱い方法について解説します！

具体的には下記項目についてです！

個人的に一番難しいと思うところは、「JSON データ形式の値へのアクセス」です。

たとえば、下記のようなJSONデータがあるとします。

{
  "status": "OK",
  "geocoded_waypoints" : [
     {
        "geocoder_status" : "OK",
        "place_id" : "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types" : [ "locality", "political" ]
     },
     {
        "geocoder_status" : "OK",
        "place_id" : "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types" : [ "locality", "political" ]
     },
     {
        "geocoder_status" : "OK",
        "place_id" : "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types" : [ "locality", "political" ]
     },
     {
        "geocoder_status" : "OK",
        "place_id" : "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types" : [ "locality", "political" ]
     }
  ]
}

引用元 : Google Directions API 公式ページ

上記は Google Directions API という Google の経路情報を取得できる API から取得できるデータの一部です。

仕事で「これを配列 or データにいれてくれーい」とお客さんからいわれたんですね（イヤー大変でした...）

しかしコツをつかめば、どんな複雑なデータ形式でも必ず取得できるようになります。

この記事では、そういった JSON のデータの取り扱いについてご紹介します！！

JSONとは？

JSON (JavaScript Object Notation)とは、JavaScriptのオブジェクトリテラル記法のことです。

「なんのこっちゃ」と思うかもしれませんが、こいつを使えば異なるプログラミング言語でもデータのやり取りができるんです！

これがすごく便利な特徴で、あるデータがPythonやPHP、JavaScript で読み込むことも可能です！

そのため Google やシステムトレードのなどの API で利用されています。

本当に便利なデータ形式なので、知っておいて絶対に損がない知識です！

JSON ファイルの読み込み

たとえば、下記内容の 「test.json」という JSON ファイルがあります。

{
  "status": "OK",
  "geocoded_waypoints" : [
     {
        "geocoder_status" : "OK",
        "place_id" : "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types" : [ "locality", "political" ]
     },
     {
        "geocoder_status" : "OK",
        "place_id" : "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types" : [ "locality", "political" ]
     },
     {
        "geocoder_status" : "OK",
        "place_id" : "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types" : [ "locality", "political" ]
     },
     {
        "geocoder_status" : "OK",
        "place_id" : "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types" : [ "locality", "political" ]
     }
  ]
}

このJSON ファイルの読み込み方法について、下記のソースコードのようにします。

import json

json_open = open('test.json', 'r')
json_data = json.load(json_open)

print(json_data)

上記ソースコードについて順番に説明します。

出力結果は下記になります。

{'status': 'OK', 'geocoded_waypoints': [{'geocoder_status': 'OK', 'place_id': 'ChIJ7cv00DwsDogRAMDACa2m4K8', 'types': ['locality', 'political']}, {'geocoder_status': 'OK', 'place_id': 'ChIJ69Pk6jdlyIcRDqM1KDY3Fpg', 'types': ['locality', 'political']}, {'geocoder_status': 'OK', 'place_id': 'ChIJgdL4flSKrYcRnTpP0XQSojM', 'types': ['locality', 'political']}, {'geocoder_status': 'OK', 'place_id': 'ChIJE9on3F3HwoAR9AhGJW_fL-I', 'types': ['locality', 'political']}]}

JSON データ形式の値へのアクセス

たとえば、下記内容の 「test.json」という JSON ファイルがあります。

{
  "status": "OK",
  "geocoded_waypoints" : [
     {
        "geocoder_status" : "OK",
        "place_id" : "ChIJ7cv00DwsDogRAMDACa2m4K8",
        "types" : [ "locality", "political" ]
     },
     {
        "geocoder_status" : "OK",
        "place_id" : "ChIJ69Pk6jdlyIcRDqM1KDY3Fpg",
        "types" : [ "locality", "political" ]
     },
     {
        "geocoder_status" : "OK",
        "place_id" : "ChIJgdL4flSKrYcRnTpP0XQSojM",
        "types" : [ "locality", "political" ]
     },
     {
        "geocoder_status" : "OK",
        "place_id" : "ChIJE9on3F3HwoAR9AhGJW_fL-I",
        "types" : [ "locality", "political" ]
     }
  ]
}

上記ファイルを読み込み、各変数にアクセスする方法について説明します。

まずは簡単なところからいきます。

{
  "status": "OK",
}

上記の「status」の値である「OK」にアクセスしようとする場合、下記のようにすれば OK です。

import json

json_open = open('test.json', 'r')
json_data = json.load(json_open)

print(json_data['status'])
print(json_data.get('status'))

「status」の値である「OK」を取得するためには、

のどちらかの値でやれば「OK」という値が表示されます。

つぎに少しややこしいところをいきます。

下記の「geocoded_waypoints」-> geocoder_status の値「OK」を取得する場合を考えます。

"geocoded_waypoints" : [
     { 
       "geocoder_status" : "OK", 
       "place_id" : "ChIJ7cv00DwsDogRAMDACa2m4K8", 
       "types" : [ "locality", "political" ] 
    },

JSON のややこしいところは括弧がめっちゃあるところだと思います。

そんなときは下記を参考にしてください。

geocoded_waypoints : [ { ~ } ] とは、geocoded_waypoints にさらに辞書型変数があってそれが配列で構成されていると思ってください。

ソースコードは下記になります。

import json

json_open = open('test.json', 'r')
json_data = json.load(json_open)

print(json_data['geocoded_waypoints'][0]['geocoder_status'])
print(json_data.get('geocoded_waypoints')[0].get('geocoder_status'))

上記の[0]とは配列のインデックスです。

例えば、array[0] = apple、array[1] = banana ・・・という配列がある場合、

これと同じ要領で、geocoded_waypoints の[0]番目の値を参照するために

geocoded_waypoints [0]とし、その値の['geocoder_status']にアクセスすれば値がとれるということです。

つまり下記どちらかの値を指定すれば値が取れます。

JSON ファイルへ書き込み

JSON ファイルへの書き込み方法について、下記のソースコードで実施します。

import json

human = {
    "human":
        [
            {"height": "178", "weight": "100"},
            {"height": "169", "weight": "50"}
        ]
}

with open("test.json", "w") as f:
    json.dump(human, f)

上記は「human」という辞書型変数があり、それを「test.json」に格納した場合の処理を記述しています。

最後に

いかがでしたでしょうか？

世の中には、JSON データ形式で扱われる API が様々なあります。

この記事を参考にぜひ JSON データ形式をマスターしていただければ幸いです。

ではでは。