Japanese forward geocoding from an address to coordinates
Japanese forward geocoding from an address to coordinates. Keywords: Japan geocoder, address to coordinates, building-level geocode, Jageocoder, chome, block, lot, house. Returns provider-neutral local candidates, coordinates, address IDs, hierarchy levels, unmatched tails, and partial-match warnings. Jageocoder level 5/6 is oaza/aza, level 7 is block, and level 8 is a building or house node when present in the dictionary; town-level evidence is not a door-number or coordinate accuracy claim.
Paid test badge: not yet. The checks above are free: we call the tool without paying and read the payment request it sends back. The Verified badge needs paid calls whose answers match the promised output, and nobody can buy a badge.
Endpoint
POST https://api.jpverify.com/jp-address/geocode
| Category | Everything else |
|---|---|
| Provider host | api.jpverify.com |
| Networks | eip155:8453 |
| Payment schemes | exact |
| Self-reported calls, 30 days | 2 from 2 payers (the provider's figure, not ours) |
Our checks, last 30 days
| Day | Result | HTTP | Asked | Time |
|---|---|---|---|---|
| 2026-09-24 | valid payment request | 402 | $0.005 | 683 ms |
Example input (from the provider)
{
"body": {
"address": "\u6771\u4eac\u90fd\u5343\u4ee3\u7530\u533a\u5343\u4ee3\u75301\u4e01\u76ee1\u756a1\u53f7",
"max_candidates": 3
},
"bodyType": "json",
"method": "POST",
"type": "http"
}
Promised output schema (from the provider)
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"input": {
"additionalProperties": false,
"properties": {
"body": {
"additionalProperties": false,
"properties": {
"address": {
"description": "Forward-geocoded Japanese address. / \u30b8\u30aa\u30b3\u30fc\u30c9\u3059\u308b\u65e5\u672c\u4f4f\u6240\u3002",
"maxLength": 500,
"type": [
"string",
"null"
]
},
"components": {
"description": "Parsed address components when address is already parsed; at least one non-empty address field is required. / \u89e3\u6790\u6e08\u307f\u4f4f\u6240\u69cb\u6210\u8981\u7d20\u3002\u7a7a\u3067\u306a\u3044\u4f4f\u6240\u9805\u76ee\u30921\u3064\u4ee5\u4e0a\u6307\u5b9a\u3057\u307e\u3059\u3002",
"type": [
"object",
"null"
]
},
"max_candidates": {
"default": 3,
"description": "Maximum candidates. / \u5019\u88dc\u6570\u4e0a\u9650\u3002",
"maximum": 10,
"minimum": 1,
"type": "integer"
},
"minimum_acceptable_level": {
"description": "Minimum hierarchy level accepted as matched; lower results are partial. / matched\u3068\u3057\u3066\u53d7\u3051\u5165\u308c\u308b\u6700\u5c0f\u968e\u5c64\u3002\u4e0b\u4f4d\u5019\u88dc\u306fpartial\u3002",
"maximum": 8,
"minimum": 1,
"type": [
"integer",
"null"
]
},
"postal_code": {
"description": "Optional postal-code evidence. / \u4efb\u610f\u306e\u90f5\u4fbf\u756a\u53f7\u6839\u62e0\u3002",
"pattern": "^\\d{3}-?\\d{4}$",
"type": [
"string",
"null"
]
},
"provider": {
"default": "auto",
"description": "Geocoder provider selection. / \u5730\u7406\u30b3\u30fc\u30c9\u30d7\u30ed\u30d0\u30a4\u30c0\u3002",
"enum": [
"auto",
"local_jageocoder"
],
"type": "string"
}
},
"type": "object"
},
"bodyType": {
"enum": [
"json",
"form-data",
"text"
],
"type": "string"
},
"method": {
"enum": [
"POST",
"PUT",
"PATCH"
],
"type": "string"
},
"type": {
"const": "http",
"type": "string"
}
},
"required": [
"type",
"method",
"bodyType",
"body"
],
"type": "object"
},
"output": {
"properties": {
"example": {
"candidate_count": {
"type": "integer"
},
"candidates": {
"items": {
"properties": {
"address_id": {
"type": [
"integer",
"string",
"null"
]
},
"confidence": {
"type": "number"
},
"granularity": {
"type": "string"
},
"latitude": {
"type": [
"number",
"null"
]
},
"longitude": {
"type": [
"number",
"null"
]
},
"match_completeness": {
"type": "string"
},
"match_level": {
"type": "integer"
},
"normalized": {
"type": "string"
},
"reasons": {
"items": {
"type": "string"
},
"type": "array"
},
"source": {
"type": "string"
},
"unmatched_tail": {
"type": [
"string",
"null"
]
}
},
"type": "object"
},
"type": "array"
},
"dictionary_version": {
"type": [
"string",
"null"
]
},
"geocoder_status": {
"type": "string"
},
"matched": {
"type": [
"string",
"null"
]
},
"minimum_acceptable_level": {
"type": [
"integer",
"null"
]
},
"precision_satisfied": {
"type": "boolean"
},
"status": {
"type": "string"
},
"type": "object",
"upstream_matched": {
"items": {
"type": "string"
},
"type": "array"
},
"verified_level": {
"type": [
"integer",
"null"
]
},
"warnings": {
"items": {
"type": "string"
},
"type": "array"
}
},
"type": {
"type": "string"
}
},
"required": [
"type"
],
"type": "object"
}
},
"required": [
"input"
],
"type": "object"
}