郵便番号検索API

リクエストURL

目次

• 概要
• リクエストパラメーター一覧
• レスポンス
• レスポンスフィールド
• サンプルレスポンス
• エラー

概要

• 郵便番号検索APIでは、郵便番号に関する情報を取得できます。
• 郵便番号を指定して、位置情報（地点名・緯度・経度）と日本郵便の郵便番号名称を取得できます。

リクエストパラメーター一覧

「RESTリクエストの構築（GET）」をご参照ください。

サンプルリクエスト

郵便番号〒105-0011のリクエストです。

https://map.yahooapis.jp/search/zip/V1/zipCodeSearch?query=105-0011&appid=＜あなたのアプリケーションID＞

API使用上の注意

URLの最大の長さは2048バイトです。
URLをエンコードして指定するパラメーターもありますが、エンコード後のURLの長さが2048バイトをこえないようにしてください。

レスポンス

出力形式にXMLを指定（output=xml）の場合、XMLを返します。レスポンスフィールドをご参照ください。

レスポンスフィールド

サンプルレスポンス

郵便番号〒105-0011のレスポンスです。

<YDF xmlns="http://olp.yahooapis.jp/ydf/1.0" totalResultsReturned="1" totalResultsAvailable="1" firstResultPosition="1">
  <ResultInfo>
    <Count>1</Count>
    <Total>1</Total>
    <Start>1</Start>
    <Status>200</Status>
    <Description/>
    <Copyright/>
    <Latency>0.023</Latency>
  </ResultInfo>
  <Feature>
    <Id>d30c42d8a8cb04ee730d1e5846ea2a8a</Id>
    <Gid/>
    <Name>〒105-0011</Name>
    <Geometry>
      <Type>point</Type>
      <Coordinates>139.74816650,35.65757726</Coordinates>
    </Geometry>
    <Category>郵便番号</Category>
    <Category>町域郵便番号</Category>
    <Description>Yahoo!郵便番号検索</Description>
    <Style/>
    <Property>
      <Uid>2281d2dd75f52ee9ef0ba86149310b0cf710aedd</Uid>
      <CassetteId>3ee7f7f5fe1ef2267e319b15168e37d3</CassetteId>
      <Country>
        <Code>JP</Code>
        <Name>日本</Name>
      </Country>
      <Address>東京都港区芝公園</Address>
      <GovernmentCode>13103</GovernmentCode>
      <AddressMatchingLevel>6</AddressMatchingLevel>
      <PostalName>東京都港区芝公園</PostalName>
      <Station>
        <Id>22584</Id>
        <SubId>2258401</SubId>
        <Name>御成門</Name>
        <Railway>都営三田線</Railway>
        <Exit>A1</Exit>
        <ExitId>3607</ExitId>
        <Distance/>
        <Time>6</Time>
        <Geometry>
          <Type>point</Type>
          <Coordinates>139.7504467,35.6594219</Coordinates>
        </Geometry>
      </Station>
      <Station>
        <Id>22712</Id>
        <SubId>2271201</SubId>
        <Name>芝公園</Name>
        <Railway>都営三田線</Railway>
        <Exit>A4</Exit>
        <ExitId>4055</ExitId>
        <Distance/>
        <Time>8</Time>
        <Geometry>
          <Type>point</Type>
          <Coordinates>139.7497167,35.6544875</Coordinates>
        </Geometry>
      </Station>
      <Station>
        <Id>22815</Id>
        <SubId>2281501</SubId>
        <Name>大門(東京都)</Name>
        <Railway>都営浅草線/都営大江戸線</Railway>
        <Exit>A6</Exit>
        <ExitId>4541</ExitId>
        <Distance/>
        <Time>8</Time>
        <Geometry>
          <Type>point</Type>
          <Coordinates>139.7539208,35.6569678</Coordinates>
        </Geometry>
      </Station>
    </Property>
  </Feature>
</YDF>

エラー

以下は、リクエストに対するエラーレスポンスです。

<?xml version="1.0" encoding="utf-8" ?>
<Error>
  <Detail></Detail>
  <Code>403</Code>
</Error>