地址與運送資料 API

Postrate 將各國地址登記資料與物流業者公告運費整合為一致的 API,讓結帳表單自動填寫,每個包裹在寄出前就能算出運費。

Postrate

結帳所需的地址與運費,直接來自公布這些資料的機關。

產品

三大基礎元件,支援所有寄送需求。

一組金鑰、一套資料模型,所有國家都以相同方式處理。

隨顧客輸入即時提供建議:街道、門牌號碼、郵遞區號與城鎮可依任意順序輸入,有無重音符號皆可,支援拉丁字母、西里爾字母、韓文與中文。

  • 每筆結果拆分為街道、門牌號碼、郵遞區號與城鎮
  • 每筆地址的經緯度
  • 每次按鍵只需一次無狀態呼叫

資料

直接取自登記資料,而非從地圖擷取。

每筆地址都來自核發該地址的機關:各國地址登記、地籍、統計機關與郵政業者。

權威來源

官方門牌號碼與郵遞區號,與主管機關公布的內容一致。

持續更新

每個來源依各自的排程重新載入,從每日到每季不等,新版本上線前都會經過檢查。

合法授權使用

我們會追蹤每個來源的授權與標示條款,讓您清楚了解資料的使用範圍。

資料來源包括
  • Base Adresse Nationale
  • Kadaster BAG
  • CartoCiudad (IGN)
  • swisstopo
  • G-NAF (Geoscape)
  • Statistics Canada NAR
  • US DOT National Address Database
  • ANNCSU (Istat)
  • ČÚZK RÚIAN
  • Kartverket
  • Danmarks Adresseregister
  • Toitū Te Whenua LINZ
  • BEV Adressregister
  • 행정안전부 도로명주소

開發人員

簡潔的 REST API,回傳格式一致的 JSON。

使用您的金鑰傳送請求,即可取得結構化的 JSON。每個國家的欄位都相同,一次整合就能涵蓋所有國家。

  • 唯讀權限的 API 金鑰,可隨時撤銷
  • 可用於產生用戶端的 OpenAPI 規格
  • 透過 HTTPS 提供
$ curl -G https://api.postrate.fyi/api/v1/addresses/autocomplete \
  -H "X-API-Key: $POSTRATE_KEY" \
  -d country=NL --data-urlencode "q=damrak 1 amst"
200 OK · application/json
[
  {
    "label": "Damrak 1, 1012 LG Amsterdam",
    "street": "Damrak",
    "number": "1",
    "postal_code": "1012 LG",
    "town": "Amsterdam",
    "country": "NL",
    "lat": 52.3771466,
    "lng": 4.8980411
  }
]

開始使用

申請 API 使用

所有帳戶皆可使用示範;API 金鑰目前僅限受邀使用。請告訴我們您需要哪些國家、正在開發什麼,我們會再與您聯繫試用金鑰的事宜。

  • 針對您需要的國家提供試用存取權
  • 協助您將 API 整合到結帳流程

這些資料僅用於回覆您的申請。