郵便番号から住所を調べるショートカット(APIから値を取り出す)
ショートカットは、インターネット上のサービスに問い合わせて、返ってきたデータを使うことができます。この問い合わせ先を「API」と呼びます。ここでは、郵便番号から住所を調べる無料のAPIを使って、郵便番号を入れると住所が出るショートカットを作ります。「問い合わせる → 返ってきた中から値を取り出す」という流れは、ほかのAPIでも同じです。
このショートカットでできること
- 郵便番号を入れると、住所(都道府県・市区町村・町名)を表示する
- APIから返ってきたデータの中から、必要な値だけを取り出す
- iOS 27 の画面で確認しています
メモ
使うのは、郵便番号検索API(zipcloud)です。登録なしで使えます。サービス側の都合で、使えなくなったり、返ってくる形が変わったりすることがあります。
並べるアクション
新しいショートカットを作り、次のアクションを上から順に追加します。アクションの探し方と追加のしかたはショートカットの作り方の基本で説明しています。
- 入力を要求
- URL
- URLの内容を取得
- 辞書の値を取得
- リストから項目を取得
- 辞書の値を取得
- 辞書の値を取得
- 辞書の値を取得
- テキスト
- コンテンツを表示
アクションが10個あり、「辞書の値を取得」は合計4つ使います。
各アクションの設定
上から順に設定していきます。それぞれのアクションが何をしているかも、あわせて書いています。
1. 入力を要求
郵便番号を入れてもらうアクションです。種類は「テキスト」のままにします。「プロンプト」には、「郵便番号は?(ハイフンなしの7けた)」のように、聞きたいことを入れておくとわかりやすくなります(下の画面では、プロンプトを空のままにしています)。
2. URL
問い合わせ先のアドレスを作ります。次の文字を入力し、そのすぐうしろに、変数の「指定入力」(1の結果)を入れます。
https://zipcloud.ibsnet.co.jp/api/search?zipcode=
3. URLの内容を取得
2で作ったアドレスに問い合わせて、返ってきたデータを受け取ります。「URL の内容を取得」のままで大丈夫です。
4. 辞書の値を取得
返ってきたデータは、「名前(キー)」と「値」の組がいくつも入った形(辞書)になっています。住所は「results」という名前の中に入っているので、「キー」に「results」と入力します。「URLの内容 内の results の 値 を取得」になります。
5. リストから項目を取得
「results」の中身は、住所の候補が並んだリストです。「辞書の値 から 最初の項目 を取得」のままにして、1つ目を取り出します。

6〜8. 辞書の値を取得(3つ)
5で取り出した1件の中に、住所が3つに分かれて入っています。3つの「辞書の値を取得」は、どれも「リストからの項目」(5の結果)から取り出すようにして、キーを次のように入れます。
| どれ | キー | 取り出せるもの |
|---|---|---|
| 6つ目 | address1 | 都道府県 |
| 7つ目 | address2 | 市区町村 |
| 8つ目 | address3 | 町名 |
並べただけだと、7つ目と8つ目は、すぐ上のアクションの結果(「辞書の値」)から取り出す形になっています。左側をタップして「変数を選択」を選び、5の「リストからの項目」に入れ直してください。
9. テキスト
取り出した3つをつなげます。入力欄をタップし、「変数を選択」から、6・7・8の「辞書の値」を順番に入れます。
10. コンテンツを表示
「テキスト」が入っていれば、そのままで大丈夫です。

実行する
実行すると入力欄が出るので、郵便番号をハイフンなしで入れて「完了」をタップします。

最初に実行したときは、ショートカットがこのサービスに接続してよいかを聞かれます。「許可」をタップすると先に進みます。確認の文に出るのはショートカットの名前で、画面は名前を変える前に試したときのものです。

「1000001」を入れると、「東京都千代田区千代田」と表示されました。

うまくいかないとき
| こんなとき | 見るところ |
|---|---|
| 何も表示されない | 郵便番号が7けたの数字になっているか。ハイフンを入れていないか |
| 住所の一部しか出ない | 6〜8の「辞書の値を取得」が、3つとも「リストからの項目」から取り出しているか。キーのつづりが合っているか |
| 返ってきた中身を見たい | 3のすぐ下に「コンテンツを表示」を入れて実行すると、受け取ったデータがそのまま表示される |
どのキーに何が入っているかは、APIごとにちがいます。別のAPIを使うときは、まず返ってきたデータをそのまま表示させて、キーの名前と入れ子のようすを確かめてから、取り出す手順を組み立てます。
ポイント
APIの中には、利用するための「キー」(合い言葉のような文字)が必要なものがあります。そういう値をショートカットに入れたときは、そのショートカットを人に渡さないでください。
