Japan Address Geocode · JP Address Geocode

import { wrapFetchWithPayment } from "@x402/fetch";
import { privateKeyToAccount } from "viem/accounts";

const account = privateKeyToAccount(process.env.PRIVATE_KEY);
const fetchWithPay = wrapFetchWithPayment(fetch, account);

const res = await fetchWithPay("https://api.jpverify.com/jp-address/geocode", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    "address": "東京都千代田区千代田1丁目1番1号",
    "max_candidates": 3
  }),
});
const data = await res.json();

curl -X POST \
  "https://api.jpverify.com/jp-address/geocode" \
  -H "Content-Type: application/json" \
  -d '{"address":"東京都千代田区千代田1丁目1番1号","max_candidates":3}' \
  -H "X-PAYMENT: <signed x402 payment>"

{
  "candidate_count": 1,
  "candidates": [
    {
      "address_id": 123,
      "confidence": 0.98,
      "granularity": "building",
      "latitude": 35.6852,
      "longitude": 139.7528,
      "match_completeness": "exact",
      "match_level": 8,
      "normalized": "東京都千代田区千代田1丁目1番1号",
      "reasons": [
        "all_requested_components_matched"
      ],
      "source": "Jageocoder local dictionary",
      "unmatched_tail": null
    }
  ],
  "dictionary_version": null,
  "geocoder_status": "ready",
  "matched": "東京都千代田区千代田一丁目一番一号",
  "minimum_acceptable_level": 8,
  "precision_satisfied": true,
  "status": "matched",
  "upstream_matched": [
    "東京都千代田区千代田一丁目一番一号"
  ],
  "verified_level": 8,
  "warnings": []
}