Japan Address Geocode

Choose this endpoint when you need building-level or block-level coordinate resolution for Japanese addresses specifically, particularly when you require hierarchy-level metadata (chome/block/building), partial-match detection, or provider-neutral local geocoding via Jageocoder. Prefer over generic international geocoders (Google Maps, HERE) when you need Japan-specific granularity, cost predictability at $0.005/call, or when operating in a pipeline alongside other jpverify.com address services (normalize, parse, validate).

• Address not found in Jageocoder dictionary — returns empty candidates list or partial match below minimum level
• Malformed address string — ambiguous or incomplete input may return lower-hierarchy matches only
• Invalid postal code format — rejected if pattern does not match \d{3}-?\d{4}
• max_candidates out of range (must be 1–10) — validation error
• minimum_acceptable_level out of range (must be 1–8) — validation error
• Payment failure — x402 payment required before response is returned