ネストされたJSONの操作

pandasで効率よくデータを取り込む

Amany Mahfouz

Instructor

ネストされたJSON

JSONは属性と値の組を持つオブジェクト
値がオブジェクトなら、そのJSONはネストされている

Yelp Business APIドキュメントのJSONレスポンス例

Yelpのレスポンス例。座標と住所のネストを強調

Yelpのレスポンス例。カテゴリのネストを強調

Yelpのレスポンス例。businesses配下のネスト済みレコードを強調

# ネストを含む列を表示
print(bookstores[["categories", "coordinates", "location"]].head(3))

                                          categories  \
0   [{'alias': 'bookstores', 'title': 'Bookstores'}]   
1  [{'alias': 'bookstores', 'title': 'Bookstores'...   
2   [{'alias': 'bookstores', 'title': 'Bookstores'}]     

                                         coordinates  \
0  {'latitude': 37.7975997924805, 'longitude': -1...   
1  {'latitude': 37.7885846793652, 'longitude': -1...   
2  {'latitude': 37.7589836120605, 'longitude': -1...    

                                            location  
0  {'address1': '261 Columbus Ave', 'address2': '...  
1  {'address1': '50 2nd St', 'address2': '', 'add...  
2  {'address1': '866 Valencia St', 'address2': ''...

pandas.io.json

pandas.io.json サブモジュールはJSONの読み書き用ツールを提供
- 個別に import が必要
json_normalize()
- 辞書/辞書のリストを受け取る（pd.DataFrame()同様）
- 平坦化したデータフレームを返す
- 既定の列名パターン: attribute.nestedattribute
- 区切りは sep 引数で変更可

ネストJSONデータの読み込み

import pandas as pd
import requests

from pandas.io.json import json_normalize



# ヘッダー、パラメータ、APIエンドポイントを設定
api_url = "https://api.yelp.com/v3/businesses/search"
headers = {"Authorization": "Bearer {}".format(api_key)}
params = {"term": "bookstore", 
          "location": "San Francisco"}


# API呼び出しを行い、JSONデータを取得
response = requests.get(api_url, 
                        headers=headers,
                        params=params)
data = response.json()

# データを平坦化してデータフレームへ。区切りは _
bookstores = json_normalize(data["businesses"], sep="_")
print(list(bookstores))

['alias', 
 'categories',
 'coordinates_latitude',
 'coordinates_longitude',
 ...
 'location_address1',
 'location_address2',
 'location_address3',
 'location_city',
 'location_country',
 'location_display_address',
 'location_state',
 'location_zip_code',
 ...
 'url']

深いネストのデータ

print(bookstores.categories.head())

0     [{'alias': 'bookstores', 'title': 'Bookstores'}]
1    [{'alias': 'bookstores', 'title': 'Bookstores'...
2     [{'alias': 'bookstores', 'title': 'Bookstores'}]
3     [{'alias': 'bookstores', 'title': 'Bookstores'}]
4    [{'alias': 'bookstores', 'title': 'Bookstores'...
Name: categories, dtype: object

深いネストのデータ

json_normalize()
- record_path: ネスト先への属性（文字列/リスト）
- meta: 併せて読み込む他の属性のリスト
- meta_prefix: meta列名の接頭辞

深いネストのデータ

# categoriesを平坦化し、店舗情報を付与
df = json_normalize(data["businesses"],
                    sep="_",

                    record_path="categories",

                    meta=["name", 
                          "alias", 
                          "rating", 
                          ["coordinates", "latitude"], 
                          ["coordinates", "longitude"]],

                    meta_prefix="biz_")

print(df.head(4))

        alias               title                biz_name  \
0  bookstores          Bookstores   City Lights Bookstore   
1  bookstores          Bookstores  Alexander Book Company   
2  stationery  Cards & Stationery  Alexander Book Company   
3  bookstores          Bookstores       Borderlands Books   

                              biz_alias  biz_rating  biz_coordinates_latitude  \
0   city-lights-bookstore-san-francisco         4.5                 37.797600   
1  alexander-book-company-san-francisco         4.5                 37.788585   
2  alexander-book-company-san-francisco         4.5                 37.788585   
3       borderlands-books-san-francisco         5.0                 37.758984   

   biz_coordinates_longitude  
0                -122.406578  
1                -122.400631  
2                -122.400631  
3                -122.421638

練習しましょう！

pandasで効率よくデータを取り込む