APIを試す
エンドポイントを選び、値を変更して「送信」を押してください。リクエストはブラウザからapi.mygeocode.comに送られ、JSONの回答が新しいタブで開きます。これは、お使いのアドレスがキーなしで得ている1日あたり2,500件の無料リクエストから差し引かれます。キーを貼り付ければ、代わりにそのキーの分として数えられます。キーが必要ですか？メールアドレスで新規登録すれば、1分で取得できます。
表示されている値でのレスポンス例
{
"status": "ok",
"query": "221B Baker Street, London",
"results": [
{
"formatted": "221B Baker Street, London NW1 6XE, United Kingdom",
"lat": 51.523767,
"lon": -0.158555,
"type": "address",
"precision": "house",
"confidence": 0.97,
"place_id": "gb.addr.7f3c2a19",
"components": {
"house_number": "221B",
"road": "Baker Street",
"neighbourhood": "Marylebone",
"city": "London",
"state": "England",
"postcode": "NW1 6XE",
"country": "United Kingdom",
"country_code": "gb"
},
"bounds": { "north": 51.523917, "south": 51.523617, "east": -0.158305, "west": -0.158805 }
}
]
}番地を削除してみると、precisionがhouseからstreetに変わるのが分かります。リファレンス
表示されている値でのレスポンス例
{
"status": "ok",
"lat": 48.8584,
"lon": 2.2945,
"result": {
"formatted": "5 Avenue Anatole France, 75007 Paris, France",
"lat": 48.85837,
"lon": 2.29448,
"distance_m": 12,
"type": "address",
"precision": "house",
"components": {
"house_number": "5",
"road": "Avenue Anatole France",
"suburb": "7th Arrondissement",
"city": "Paris",
"state": "Ile-de-France",
"postcode": "75007",
"country": "France",
"country_code": "fr"
}
}
}0と0を試してみてください。海上の地点も正当な問い合わせなので、status: okとともに"result": nullが返ります。リファレンス
表示されている値でのレスポンス例
{
"status": "ok",
"query": "10 Downing",
"suggestions": [
{ "text": "10 Downing Street, London SW1A 2AA, United Kingdom", "lat": 51.503396, "lon": -0.12764, "type": "address", "precision": "house", "place_id": "gb.addr.7f3c2a19" },
{ "text": "10 Downing Place, Cambridge CB2 3EN, United Kingdom", "lat": 52.203042, "lon": 0.121811, "type": "address", "precision": "house", "place_id": "gb.addr.a01d9e44" },
{ "text": "10 Downing Road, Dagenham RM9 6NP, United Kingdom", "lat": 51.536118, "lon": 0.137204, "type": "address", "precision": "house", "place_id": "gb.addr.c58b7e02" }
]
}どの候補にも座標が含まれるため、候補を選んだ後に2回目の呼び出しは必要ありません。リファレンス
表示されている値でのレスポンス例
{
"status": "ok",
"ip": "8.8.8.8",
"version": 4,
"country": "United States",
"country_code": "US",
"region": "California",
"region_code": "CA",
"city": "Mountain View",
"postcode": "94043",
"lat": 37.4056,
"lon": -122.0775,
"timezone": "America/Los_Angeles",
"asn": 15169,
"org": "Google LLC",
"is_datacenter": true,
"is_proxy": false,
"is_private": false
}表示されている値でのレスポンス例
{
"status": "ok",
"ip": "2001:4860:4860::8888",
"version": 6,
"prefix": "2001:4860::/32",
"country": "United States",
"country_code": "US",
"region": "California",
"region_code": "CA",
"city": "Mountain View",
"postcode": "94043",
"lat": 37.4056,
"lon": -122.0775,
"timezone": "America/Los_Angeles",
"asn": 15169,
"org": "Google LLC",
"is_datacenter": true,
"is_proxy": false,
"is_private": false
}表示されている値でのレスポンス例
{
"status": "ok",
"lat": 35.6762,
"lon": 139.6503,
"timezone": "Asia/Tokyo",
"abbreviation": "JST",
"utc_offset": "+09:00",
"utc_offset_seconds": 32400,
"dst": false,
"timestamp": 1756335245,
"local_time": "2026-08-28T08:34:05+09:00",
"country_code": "JP",
"next_transition": null
}表示されている値でのレスポンス例
{
"status": "ok",
"results": [
{ "lat": 27.9881, "lon": 86.925, "elevation_m": 8752.1, "resolution_m": 30 }
]
}複数の地点をまとめて指定する場合は、代わりにlocations=lat,lon|lat,lonを使用してください。リファレンス
表示されている値でのレスポンス例
{
"status": "ok",
"postcode": "10001",
"country_code": "US",
"results": [
{
"postcode": "10001",
"place": "New York",
"region": "New York",
"region_code": "NY",
"country": "United States",
"country_code": "US",
"lat": 40.7484,
"lon": -73.9967
}
]
}レスポンスの読み方。すべての応答にはstatusフィールドがあります。ジオコーディングの結果にはhouse、street、postcode、adminのいずれかのprecisionが含まれるため、その地点をどの程度信頼できるかがわかります。レスポンスヘッダーにはX-Quota-UsedとX-Quota-Resetが含まれ、ブラウザの開発者ツールで確認できます。空欄の任意フィールドはリクエストから除外されます。フォームではヘッダーを設定できないため、ここではキーをkeyパラメータとして送信しますが、コードではX-API-Keyヘッダーを使用してください。すべてのフィールドについてはドキュメントをご覧ください。