本文へ移動
上級

郵便番号から住所を調べるショートカット(APIから値を取り出す)

ショートカットは、インターネット上のサービスに問い合わせて、返ってきたデータを使うことができます。この問い合わせ先を「API」と呼びます。ここでは、郵便番号から住所を調べる無料のAPIを使って、郵便番号を入れると住所が出るショートカットを作ります。「問い合わせる → 返ってきた中から値を取り出す」という流れは、ほかのAPIでも同じです。

このショートカットでできること

  • 郵便番号を入れると、住所(都道府県・市区町村・町名)を表示する
  • APIから返ってきたデータの中から、必要な値だけを取り出す
  • iOS 27 の画面で確認しています

メモ

使うのは、郵便番号検索API(zipcloud)です。登録なしで使えます。サービス側の都合で、使えなくなったり、返ってくる形が変わったりすることがあります。

並べるアクション

新しいショートカットを作り、次のアクションを上から順に追加します。アクションの探し方と追加のしかたはショートカットの作り方の基本で説明しています。

  1. 入力を要求
  2. URL
  3. URLの内容を取得
  4. 辞書の値を取得
  5. リストから項目を取得
  6. 辞書の値を取得
  7. 辞書の値を取得
  8. 辞書の値を取得
  9. テキスト
  10. コンテンツを表示

アクションが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つ目を取り出します。

設定し終わった全体の上の部分。URLのうしろに「指定入力」が入り、4つ目は「URLの内容 内の results の 値 を取得」になっている

6〜8. 辞書の値を取得(3つ)

5で取り出した1件の中に、住所が3つに分かれて入っています。3つの「辞書の値を取得」は、どれも「リストからの項目」(5の結果)から取り出すようにして、キーを次のように入れます。

どれキー取り出せるもの
6つ目address1都道府県
7つ目address2市区町村
8つ目address3町名

並べただけだと、7つ目と8つ目は、すぐ上のアクションの結果(「辞書の値」)から取り出す形になっています。左側をタップして「変数を選択」を選び、5の「リストからの項目」に入れ直してください。

9. テキスト

取り出した3つをつなげます。入力欄をタップし、「変数を選択」から、6・7・8の「辞書の値」を順番に入れます。

10. コンテンツを表示

「テキスト」が入っていれば、そのままで大丈夫です。

全体の下の部分。3つの「辞書の値を取得」はどれも「リストからの項目」から取り出していて、「テキスト」に3つの「辞書の値」が並んでいる

実行する

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

実行すると入力欄が出る。画面は「1000001」と入力したところ

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

最初の実行で出る確認。「zipcloud.ibsnet.co.jp」に接続することを許可するか聞かれる

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

実行した結果。「東京都千代田区千代田」と表示された

うまくいかないとき

こんなとき見るところ
何も表示されない郵便番号が7けたの数字になっているか。ハイフンを入れていないか
住所の一部しか出ない6〜8の「辞書の値を取得」が、3つとも「リストからの項目」から取り出しているか。キーのつづりが合っているか
返ってきた中身を見たい3のすぐ下に「コンテンツを表示」を入れて実行すると、受け取ったデータがそのまま表示される

どのキーに何が入っているかは、APIごとにちがいます。別のAPIを使うときは、まず返ってきたデータをそのまま表示させて、キーの名前と入れ子のようすを確かめてから、取り出す手順を組み立てます。

ポイント

APIの中には、利用するための「キー」(合い言葉のような文字)が必要なものがあります。そういう値をショートカットに入れたときは、そのショートカットを人に渡さないでください。

ここで使ったアクションは、アクション図鑑のウェブリクエスト、辞書、リストの記事で、1つずつ説明しています。