My Geocode

Essayer l'API

Choisissez un endpoint, modifiez les valeurs, cliquez sur Envoyer. La requête part de votre navigateur vers api.mygeocode.com et la réponse JSON s'ouvre dans un nouvel onglet. Elle est décomptée des 2 500 requêtes gratuites par jour dont votre adresse dispose sans clé ; collez une clé pour qu'elle soit décomptée de la clé à la place. Vous en voulez une ? Inscrivez-vous avec une adresse e-mail et vous l'aurez en une minute.

GET /v1/forward

De 1 à 10, 5 par défaut

Codes ISO 3166-1 alpha-2 séparés par des virgules

Exemple de réponse pour les valeurs affichées

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

Essayez de supprimer le numéro de rue et observez precision passer de house à street. Référence

GET /v1/reverse

address, street, postcode, city, region ou country

Exemple de réponse pour les valeurs affichées

{
  "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"
    }
  }
}

Essayez 0 et 0 : vous obtenez "result": null avec status: ok, car un point en plein océan est une question valide. Référence

GET /v1/autocomplete

Au moins 2 caractères

Exemple de réponse pour les valeurs affichées

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

Chaque suggestion contient des coordonnées : en choisir une ne nécessite pas de second appel. Référence

GET /v1/ipv4

Laissez vide pour rechercher votre propre adresse

Exemple de réponse pour les valeurs affichées

{
  "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
}

Référence

GET /v1/ipv6

Laissez vide pour rechercher votre propre adresse

Exemple de réponse pour les valeurs affichées

{
  "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
}

Référence

GET /v1/timezone

Exemple de réponse pour les valeurs affichées

{
  "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
}

Référence

GET /v1/elevation

Exemple de réponse pour les valeurs affichées

{
  "status": "ok",
  "results": [
    { "lat": 27.9881, "lon": 86.925, "elevation_m": 8752.1, "resolution_m": 30 }
  ]
}

Pour plusieurs points à la fois, utilisez plutôt locations=lat,lon|lat,lon. Référence

GET /v1/postcode

ISO 3166-1 alpha-2. Fortement recommandé

Exemple de réponse pour les valeurs affichées

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

Référence

Lire la réponse. Chaque réponse comporte un champ status. Les résultats de géocodage indiquent une precision de type house, street, postcode ou admin, pour que vous sachiez à quel point vous fier au point. Les en-têtes de réponse incluent X-Quota-Used et X-Quota-Reset ; les outils de développement de votre navigateur les affichent. Les champs facultatifs vides ne sont pas envoyés dans la requête. Ici, votre clé est envoyée dans le paramètre key, car un formulaire ne peut pas définir d'en-tête ; dans votre code, utilisez l'en-tête X-API-Key. Consultez la documentation pour chaque champ.