APIを使ってみて理解する(お天気API編) | 瀬戸内の雲のように

APIを使ってみて理解する(お天気API編)

Posted: 2019-01-17


スポンサーリンク

目次

はじめに

これまで当ブログでは以下のような記事でウェブAPIの概要やトレンドであるREST APIについて説明してきました。

関連記事: APIとは何か?をできる限りわかりやすく説明したい
関連記事: REST APIとは何か?をできる限りわかりやすく説明したい

しかし、これらの記事を読んでも 「なんとなくわかった気はするけど、理解できているか不安」という方がいらっしゃるかと思います。

そんな時は実際に使ってみるのが一番です。百聞は一見にしかずです。
ということで、今回は実際に一般公開されているサービスのAPIを使ってみたいと思います。

 

準備するもの

・ウェブブラウザ(chromeやFirefox)
・(可能であれば)以下コマンドが使えるlinux環境
 ・curl
 ・jq

 

使うAPI

今回は Weather Hacks お天気Webサービス仕様 のAPIを使います。
最近ではいろんなサービスでAPIが公開されていますが、だいたい会員登録が必要だったりで少し手間がかかりますが、このAPIは登録不要なので準備が簡単です。

 

実際に使ってみる

早速ですが、東京のお天気を見てみます。

ブラウザで開く

以下のURLをブラウザで開いてください。

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

(コピペ用)

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

 
ブラウザに以下のような文字ばっかりの画面が表示されれば成功です。

picture

これは APIをコールし、jsonのレスポンスが返ってきた という状態です。

こちらの記事 でも説明したとおり、ウェブAPIというのは

  • HTTPを使ってやりとりし、
  • 機械が理解しやすい形式(json,XML等)で情報を表現している

ものです。ですので、HTTPで通信するウェブブラウザでアクセスすれば、jsonが返ってきた ということです。

 

jsonを整形する

とはいえ、このままでは何が表示されているかさっぱりです。
ということで こちらのjson整形サービス に表示内容をコピペしてみましょう。

一番下のほうまでスクロールすると、

title:東京都 東京 の天気
 description: {
  text: 日本付近は冬型の気圧配置となっています。 【関東甲信地方】 関東甲信地方は、おおむね晴れていますが、長野県や関東地方北部の山沿 いでは雪の降っている所があります。 18日は、冬型の気圧配置が続くため、おおむね晴れますが、長野県や関 東地方北部の山沿いでは曇りで雪の降る所があるでしょう。 19日は、冬型の気圧配置が緩み、高気圧に覆われてくるため、おおむね 晴れるでしょう。 関東近海では、19日にかけて波が高い見込みです。船舶は高波に注意し てください。 【東京地方】 19日にかけて、晴れるでしょう。
  publicTime:2019-01-18T04:43:00+0900
 }
}

という表示が見えているかと思います。

ちなみに、この情報はGUIでも見ることができます。 こちら を見ると、同じことが書いているかと思います。

このように、APIとGUIとの違いとは

情報をjsonやXMLなど機械処理しやすい形式で表現しているだけ

ということがご理解頂けたかと思います。

 

Linux環境でAPIを実行する

先程は理解のためにブラウザでAPIを実行しました。
しかし実際の利用シーンにおいてはブラウザを使うことは無いかと思います。

ということで、次はより実際の利用シーンに近い Linuxのコマンドラインから APIを実行してみます。

 
以下コマンドを実行してみてください。

curl -X GET http://weather.livedoor.com/forecast/webservice/json/v1?city=130010 | jq "."

先程の内容と同じものがCLI上に表示されたかと思います。

 

まとめ

ということで、実際にAPIを使ってみました。
実際にGUIと比較することで APIとはインターフェイスの一つで、情報の表現方法が機械向け(json, XML)である だけのことということがわかって頂けたかと思います。


スポンサーリンク




コメント一覧

2022/05/20 21:50:27

CharlaOaOaさん

writing acknowledgments dissertation
guide writing dissertation
doctoral thesis vs dissertation


2022/05/21 00:59:53

xadgchrfさん

how to apply erythromycin ophthalmic ointment erythromycin ethylsuccinate


2022/05/21 06:18:13

zgybnrsxさん

purchase provigil for sale


2022/04/08 02:54:23

Dbngplugsさん

sildenafil citrate tablets 150 mg que es el sildenafil


2022/04/08 12:10:16

Keezexictさん

how well does tadalafil work cialis tadalafil 50mg


2022/04/08 14:15:03

Fnenvunnyさん

viagra generic 100mg viagra


2022/04/08 18:07:14

Ntfbfplugsさん

liquid tadalafil cialis pills


2022/04/08 22:27:21

Crnnwongeさん

discount viagra online women viagra prescription viagra purchase viagra online


2022/04/10 10:51:48

AndaAudircurnさん

buy tadalafil online india side effects of cialis tadalafil


2022/04/11 23:45:26

Dennplugsさん

legitimate online pharmacy list canada drugs com review


2022/04/12 06:42:10

Kbwnexictさん

viagra europe over the counter viagra usa


2022/04/12 10:55:03

Fwbnvunnyさん

20 mg sildenafil generic sildenafil para mujeres


2022/04/12 15:02:07

Nmioplugsさん

sam's club pharmacy people's pharmacy


2022/04/12 18:45:23

Cmmnwongeさん

cipla tadalafil review tadalafil 20mg side effects


2022/04/13 15:19:36

Dsnnplugsさん

genoa pharmacy pharmacy tech program online


2022/04/14 06:36:45

Nbttplugsさん

how to get cialis cheaper cialis costco price


2022/04/14 01:50:02

Knrnexictさん

no prior prescription required pharmacy Tadapox


2022/04/14 02:23:47

Fuupvunnyさん

sildenafil uk viagra from canada


2022/04/14 10:12:17

Ckanwongeさん

how long does levitra take to start working cheapest generic levitra


2022/04/15 17:24:25

AnuoAudircurnさん

online india pharmacy medical pharmacy south


2022/04/16 16:39:04

Jtnnplugsさん

ivermectin ear mites stromectol cream


2022/04/17 03:17:50

Auupvunnyさん

tadalafil cialis from india generic tadalafil cost


2022/04/17 03:27:02

Enrnexictさん

canadian pharmacy non rx cialis what is cialis black 800mg


2022/04/17 09:19:57

Zbttplugsさん

dosage of ivermectin for dogs ivermectin wormers for horses


2022/04/17 11:37:05

Wevgwongeさん

viagra professional check canadian pharmacies website


2022/04/18 18:38:29

AnnoAudircurnさん

sildenafil prescription australia where can you get generic viagra


2022/04/20 01:23:43

Jnnyplugsさん

how can i get cialis in australia cialis generic cambodia


2022/04/20 11:16:20

Ahhpvunnyさん

local generic cialis in united states buy cialis no prescription overnight


2022/04/20 10:54:18

Ennsexictさん

canadian pharmacy generic viagra 100mg order viagra from canadian pharmacy


2022/04/20 17:14:50

nyyyplugsさん

dosage for levitra levitra vs cialis vs viagra


2022/04/20 18:47:57

Wnsnwongeさん

what is the real cost of levitra levitra sale


2022/04/22 00:44:48

AnuuAudircurnさん

buy phentermine online canadian pharmacy va pharmacy


2022/04/23 05:54:53

Jmmplugsさん

canadian pharmacy generic cialis Feldene


2022/04/23 15:21:48

Eaaqexictさん

canada online drugs target pharmacy


2022/04/23 21:31:35

Ntcxplugsさん

ed meds can you ship prescription drugs through fedex


2022/04/23 15:45:28

Ansnvunnyさん

shoppers drug mart pharmacy top canadian online pharmacy


2022/04/23 23:18:18

Wnnhwongeさん

freds pharmacy store bernie sanders canada drugs


2022/04/25 05:38:01

JyhAudircurnさん

ramesh rx pharmacy first medicine online pharmacy store discount code


2022/04/29 17:42:21

Jebplugsさん

female viagra pill over the counter viagra generic canada discount https://sgiviagraikn.com/


2022/04/30 02:54:59

Ebbexictさん

online canadian pharmacy ratings canadian pharmacy painkillers https://dtupharmyjn.com/


2022/04/30 03:17:54

Anbnvunnyさん

sildenafil citrate revatio does sildenafil really work https://sildenafilkiol.com/


2022/04/30 10:37:04

Wnbhwongeさん

which is better viagra or cialis or levitra cost of levitra at cvs https://glevitrargu.com/


2022/04/30 08:51:57

Nndnplugsさん

rx care pharmacy online pharmacy tech training https://jzpharmacyukj.com/


2022/05/01 16:21:27

JyhgAudircurnさん

ivermectin pubmed ivermectin safety https://stromectolujlo.com/


2022/05/03 19:59:28

Jebnplugsさん

pharmacy tech training online global pharmacy canada viagra


2022/05/04 05:08:59

Ebbeexictさん

cheap cialis alternatives buy cialis no prescription uk https://dccialisxvf.com/


2022/05/04 10:47:01

Nndenplugsさん

levitra price at walgreens levitra use instructions https://xclevitradb.com/


2022/05/05 18:01:33

JolwAudircurnさん

us online pharmacy generic viagra canadian medicine viagra https://aviagrasbt.com/


2022/05/07 21:51:36

olyjdaevさん

modafinil online purchase provigil for sale


2022/05/09 13:57:39

Jebnplugsさん

online pharmacy without prescriptions canadian prescriptions


2022/05/09 23:06:47

Ebbeexictさん

cialis paypal online cialis 100 mg usa https://dccialisxvf.com/


2022/05/09 23:18:10

Anbnvunnyさん

greenstone sildenafil sildenafil interactions https://sildenafilkiol.com/


2022/05/10 04:33:15

Nndenplugsさん

levitra side effects vs viagra levitra onset https://xclevitradb.com/


2022/05/10 06:22:02

Wnbhwongeさん

levitra 30 day free trial levitra viagra best https://glevitrargu.com/


2022/05/11 11:28:29

JolwAudircurnさん

cheap viagra free shipping order viagra online without script https://aviagrasbt.com/


2022/05/14 16:34:06

Jebnplugsさん

lorazepam online pharmacy pharmacy classes online


2022/05/15 01:24:55

MaggeeOaOaさん

liberty university dissertation
writing a masters dissertation
dissertation help online


2022/05/15 01:58:43

Anbnvunnyさん

sildenafil actavis viagra or sildenafil https://sildenafilkiol.com/


2022/05/15 07:26:24

Nndenplugsさん

levitra 10 mg schmelztabletten preisvergleich levitra not working https://xclevitradb.com/


2022/05/15 09:15:45

Wnbhwongeさん

cialis levitra price super active levitra https://glevitrargu.com/


2022/05/16 00:23:37

RegineOaOaさん

dissertation uk help
dissertation help online free
uk dissertation help


2022/05/17 20:34:54

qggqhgzoさん

http://erythromycin1m.com/# erythromycin family


2022/05/18 01:11:16

bmuqxbweさん

provigil 200mg brand


2022/05/18 17:14:15

sulofroxさん

buy modafinil 200mg pill cost provigil 100mg buy modafinil for sale


2022/05/18 17:38:41

cetolmmmさん

order provigil without prescription


2022/05/18 19:43:42

Jebnplugsさん

canadian pharmacy milwaukee ed medication


2022/05/19 04:41:48

Ebbeexictさん

cialis 36 canada cialis pharmacy https://dccialisxvf.com/


2022/05/19 04:59:56

nzdwkgoiさん

modafinil ca order generic modafinil


2022/05/19 05:09:58

Anbnvunnyさん

sildenafil citrate tablets 150mg sildenafil spray https://sildenafilkiol.com/


2022/05/19 10:39:25

Nndenplugsさん

levitra professional how much does levitra cost at walmart https://xclevitradb.com/


2022/05/19 12:23:38

Wnbhwongeさん

cost of levitra levitra death https://glevitrargu.com/


2022/05/19 13:02:16

KirstiOaOaさん

education dissertation topics
online dissertation help katalog
medical dissertation writing help


2022/05/20 16:38:30

zjrtxufwさん

cheap provigil 100mg


2022/05/20 17:44:38

JolwAudircurnさん

best price brand viagra viagra plus https://aviagrasbt.com/



コメントを投稿する


お名前


コメント内容





TOP back