Jp Address Geocode

{
  "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": []
}

# bash or zsh: see the payment challenge. Nothing is charged.
curl -sS -g -i -X POST 'https://api.jpverify.com/jp-address/geocode' \
  -H 'content-type: application/json' \
  --data-raw '{"address":"\u6771\u4eac\u90fd\u5343\u4ee3\u7530\u533a\u5343\u4ee3\u75301\u4e01\u76ee1\u756a1\u53f7","max_candidates":3}'

# x402 v2 sends the challenge base64-encoded in the PAYMENT-REQUIRED header (v1 sends it in the body).
# To read the header:
curl -sS -g -o /dev/null -D - -X POST 'https://api.jpverify.com/jp-address/geocode' \
  -H 'content-type: application/json' \
  --data-raw '{"address":"\u6771\u4eac\u90fd\u5343\u4ee3\u7530\u533a\u5343\u4ee3\u75301\u4e01\u76ee1\u756a1\u53f7","max_candidates":3}' \
  | grep -i '^payment-required:' | cut -d' ' -f2 | tr -d '\r' | base64 --decode

// npm i @x402/fetch @x402/evm viem
import { wrapFetchWithPayment, x402Client } from "@x402/fetch";
import { registerExactEvmScheme } from "@x402/evm/exact/client";
import { privateKeyToAccount } from "viem/accounts";

// Pays at most $0.005 per call.
const client = new x402Client().setSpendControls({ maxAmountPerPayment: "$0.005" });
registerExactEvmScheme(client, { signer: privateKeyToAccount(process.env.EVM_PRIVATE_KEY) });
const pay = wrapFetchWithPayment(fetch, client);

// Not sure it's safe to pay? ToolVet checks it first for $0.005. Pay for that from a separate
// client: this one is capped at $0.005 per payment. GET https://toolvet.app/api/v1/check?url=https%3A%2F%2Fapi.jpverify.com%2Fjp-address%2Fgeocode&method=POST
const res = await pay("https://api.jpverify.com/jp-address/geocode", {
  method: "POST",
  headers: { "content-type": "application/json" },
  body: JSON.stringify({
    "address": "\u6771\u4eac\u90fd\u5343\u4ee3\u7530\u533a\u5343\u4ee3\u75301\u4e01\u76ee1\u756a1\u53f7",
    "max_candidates": 3
  }),
});
console.log(res.status, await res.text());

# pip install "x402[requests,evm]"
import os
from eth_account import Account
from x402 import x402ClientSync
from x402.http.clients import x402_requests
from x402.mechanisms.evm import EthAccountSigner
from x402.mechanisms.evm.exact.register import register_exact_evm_client

# Pays at most $0.005 per call.
client = x402ClientSync().set_spend_controls({"max_amount_per_payment": "$0.005"})
register_exact_evm_client(client, EthAccountSigner(Account.from_key(os.environ["EVM_PRIVATE_KEY"])))

with x402_requests(client) as session:
    res = session.post(
        "https://api.jpverify.com/jp-address/geocode",
        json={
            "address": "\u6771\u4eac\u90fd\u5343\u4ee3\u7530\u533a\u5343\u4ee3\u75301\u4e01\u76ee1\u756a1\u53f7",
            "max_candidates": 3,
        },
    )
    print(res.status_code, res.text)