Pythonで外部APIを連携する方法！Google API・OpenWeather APIの使い方を初心者向けに解説

1. APIとは？初心者向けにやさしく解説

1. APIとは？初心者向けにやさしく解説

APIとは、アプリケーション同士をつなぐ仕組みのことです。例えば、天気アプリは外部の天気サービスから情報を取得しています。そのときに使われるのがAPIです。

料理で例えると、レストランで注文するようなものです。自分で料理を作らなくても、注文すれば料理が届きます。APIも同じで、自分でデータを用意しなくても取得できます。

2. PythonでAPIを使う準備（requestsライブラリ）

2. PythonでAPIを使う準備（requestsライブラリ）

PythonでAPIを使うには、HTTP通信を行う必要があります。そのために便利なのがrequestsライブラリです。

import requests

response = requests.get("https://api.github.com")
print(response.status_code)

このコードでは、APIにアクセスしてステータスコード（成功か失敗か）を確認しています。200なら成功です。

200

3. Google APIの基本的な使い方

3. Google APIの基本的な使い方

:contentReference[oaicite:0]{index=0}のAPIを使うと、地図や検索など様々な機能を利用できます。ここでは簡単な例としてURLからデータを取得する方法を紹介します。

import requests

url = "https://www.googleapis.com/books/v1/volumes?q=python"
response = requests.get(url)

data = response.json()
print(data["items"][0]["volumeInfo"]["title"])

この例では、本の情報を取得しています。JSON形式というデータで返ってきます。

Learning Python

4. OpenWeather APIで天気情報を取得する方法

4. OpenWeather APIで天気情報を取得する方法

:contentReference[oaicite:1]{index=1}のAPIを使うと、世界中の天気情報を取得できます。APIキーという認証情報が必要です。

import requests

api_key = "あなたのAPIキー"
city = "Osaka"
url = f"https://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key}&units=metric"

response = requests.get(url)
data = response.json()

print(data["main"]["temp"])

これで大阪の気温を取得できます。

18.5

5. JSONデータとは？初心者でも理解できる仕組み

5. JSONデータとは？初心者でも理解できる仕組み

APIから返ってくるデータはJSON形式が多いです。JSONは辞書のような構造で、キーと値の組み合わせです。

data = {
    "name": "太郎",
    "age": 20
}

print(data["name"])

太郎

このようにキーを指定することで値を取り出せます。APIでも同じ考え方です。

6. エラー処理と注意点（初心者がつまずきやすいポイント）

6. エラー処理と注意点（初心者がつまずきやすいポイント）

APIを使うときは、エラーが発生することがあります。例えば通信エラーやAPIキーのミスです。

import requests

response = requests.get("https://api.example.com")

if response.status_code == 200:
    print("成功")
else:
    print("エラーが発生しました")

このようにステータスコードを確認することで、問題を見つけやすくなります。

7. API連携のメリットと活用シーン

7. API連携のメリットと活用シーン

APIを使うことで、自分で一から機能を作らなくても高度な機能を利用できます。例えば天気アプリ、地図アプリ、翻訳ツールなどです。

Python API開発では、外部サービスと連携することで実用的なアプリを簡単に作れるのが大きな魅力です。

8. 初心者が覚えておくべき重要キーワード

8. 初心者が覚えておくべき重要キーワード

APIを学ぶうえで覚えておきたい用語をまとめます。

• HTTP通信：インターネットでデータをやり取りする仕組み
• JSON：データの形式
• APIキー：認証のための鍵
• リクエスト：データを要求すること
• レスポンス：返ってくるデータ

これらを理解すれば、外部APIの使い方が一気に分かりやすくなります。

まとめ

まとめ

Pythonで外部API連携を理解するための総まとめ

ここまで、Pythonで外部APIを連携する方法として、Google APIやOpenWeather APIの使い方を中心に、初心者でも理解できるように基礎から丁寧に解説してきました。 外部API連携は、現代のWeb開発やアプリケーション開発において非常に重要な技術であり、Python API開発のスキルを身につけることで、より実用的で高度なシステムを構築できるようになります。

APIとは、外部サービスの機能を呼び出して利用する仕組みであり、天気情報取得、書籍検索、地図表示、翻訳機能など、さまざまな用途に活用できます。 Pythonでは、requestsライブラリを使うことで、HTTP通信を簡単に実装できるため、初心者でも比較的短いコードでAPIを扱うことが可能です。

重要ポイントの振り返り

• PythonでAPIを利用するにはrequestsライブラリを使用する
• HTTPリクエストを送信し、レスポンスを受け取る仕組みを理解する
• JSON形式のデータを辞書として扱うことで値を取得できる
• APIキーを利用して認証を行う必要がある
• エラー処理を実装することで安定したプログラムを作成できる

特に初心者がつまずきやすいポイントとして、JSONデータの扱い方やレスポンスの構造理解があります。 APIから返されるデータは階層構造になっていることが多いため、どのキーに目的のデータが含まれているのかを確認することが重要です。

実務で役立つAPI連携の活用例

Python API連携は、実務においても非常に多くの場面で活用されています。 例えば、天気情報APIを利用した業務システム、Google APIを活用した検索機能、外部サービスと連携したデータ収集ツールなどがあります。 また、Webhookと組み合わせることでリアルタイムデータ連携を実現することも可能です。

サンプルプログラム（総合復習）

以下は、Pythonで外部APIを利用する基本的な流れをまとめたサンプルコードです。 APIリクエストからJSON解析、エラー処理まで一通りの処理を含んでいます。

import requests

def get_weather(city, api_key):
    url = f"https://api.openweathermap.org/data/2.5/weather?q={city}&appid={api_key}&units=metric"

    try:
        response = requests.get(url)

        if response.status_code == 200:
            data = response.json()
            temp = data["main"]["temp"]
            return f"{city}の気温は{temp}度です"
        else:
            return "APIエラーが発生しました"

    except Exception as e:
        return f"通信エラー: {e}"

result = get_weather("Osaka", "あなたのAPIキー")
print(result)

このように、関数化することで再利用性を高めることができ、実務でも使いやすいコードになります。 Python API開発では、このような構造化されたコードを書くことが非常に重要です。

初心者から次のステップへ

今回学んだ内容をベースに、さらにスキルを伸ばすためには、複数のAPIを組み合わせた開発や、データベースとの連携、フロントエンドとの統合などに挑戦するのがおすすめです。 Pythonでの外部API連携スキルを習得することで、Webエンジニアとしての市場価値も高まり、実務レベルの開発にも対応できるようになります。