{"uid":"cap_7suUsqI7lX017UctGKk18","slug":"japan-address-geocode-5126946f","name":"Japan Address Geocode","description":"","url":"https://api.jpverify.com/jp-address/geocode","method":"POST","headers":{},"bodySchema":null,"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.005","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.005/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.005","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_dvH_L2fWTh1WNoNQw4H_i","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.005","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Converts a Japanese address string into geographic coordinates using building-level forward geocoding via Jageocoder, returning candidates with hierarchy levels, coordinate pairs, and partial-match warnings.","exampleAgentPrompt":"Can you geocode this Japanese address to coordinates — 東京都渋谷区道玄坂1丁目12-1 — and give me up to 3 candidates with at least block-level precision (level 7)?","exampleUseCases":[{"title":"Plot customer delivery locations on a map","prompt":"I have a list of customer addresses in Japan like '大阪府大阪市中央区難波5丁目1-60' and I need their lat/lng coordinates so I can plot them on a delivery map — can you geocode this one first and return up to 5 candidates?"},{"title":"Validate building-level address for KYC","prompt":"For our KYC workflow, can you geocode this Japanese company address '東京都千代田区丸の内2-4-1' and confirm we get at least a building-level match (level 8)? Use the local Jageocoder provider."},{"title":"Enrich property listing with coordinates","prompt":"I'm building a real estate database and need to add coordinates to a property listing at '神奈川県横浜市西区みなとみらい2丁目3-3' — can you geocode it and tell me the hierarchy level and any partial-match warnings?"}],"resultDescription":"Returns a list of geocoding candidates (up to max_candidates), each with latitude/longitude coordinates, a hierarchy level (6=chome, 7=block, 8=building/house), an address ID, the matched address components, and a flag indicating whether the match is partial (below the minimum_acceptable_level threshold).","failureModes":["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"],"whenToPreferThis":"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).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T12:54:00.135Z","isFirstParty":false}