API testen

Wählen Sie einen Endpunkt, ändern Sie die Werte, klicken Sie auf Senden. Die Anfrage geht von Ihrem Browser an api.mygeocode.com, und die JSON-Antwort öffnet sich in einem neuen Tab. Sie zählt zu den 2.500 kostenlosen Anfragen pro Tag, die Ihre Adresse ohne Schlüssel erhält; fügen Sie einen Schlüssel ein, damit sie stattdessen auf den Schlüssel angerechnet wird. Sie möchten einen? Registrieren Sie sich mit einer E-Mail-Adresse, und Sie haben ihn in einer Minute.

GET /v1/forward

1 bis 10, Standard 5

Kommagetrennte ISO-3166-1-alpha-2-Codes

Beispielantwort für die angezeigten Werte

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

Entfernen Sie testweise die Hausnummer und beobachten Sie, wie sich precision von house zu street ändert. Referenz

GET /v1/reverse

address, street, postcode, city, region oder country

Beispielantwort für die angezeigten Werte

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

Probieren Sie 0 und 0: Sie erhalten "result": null mit status: ok, denn ein Punkt im Ozean ist eine gültige Frage. Referenz

GET /v1/autocomplete

Mindestens 2 Zeichen

Beispielantwort für die angezeigten Werte

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

Jeder Vorschlag enthält Koordinaten, die Auswahl erfordert also keinen zweiten Aufruf. Referenz

GET /v1/ipv4

Leer lassen, um Ihre eigene Adresse abzufragen

Beispielantwort für die angezeigten Werte

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

Referenz

GET /v1/ipv6

Leer lassen, um Ihre eigene Adresse abzufragen

Beispielantwort für die angezeigten Werte

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

Referenz

GET /v1/timezone

Beispielantwort für die angezeigten Werte

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

Referenz

GET /v1/elevation

Beispielantwort für die angezeigten Werte

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

Für mehrere Punkte auf einmal verwenden Sie stattdessen locations=lat,lon|lat,lon. Referenz

GET /v1/postcode

ISO 3166-1 Alpha-2. Dringend empfohlen

Beispielantwort für die angezeigten Werte

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

Referenz

Die Antwort lesen. Jede Antwort hat ein Feld status. Geokodierungsergebnisse enthalten eine precision von house, street, postcode oder admin, damit Sie wissen, wie sehr Sie dem Punkt vertrauen können. Die Antwort-Header enthalten X-Quota-Used und X-Quota-Reset; die Entwicklertools Ihres Browsers zeigen sie an. Leere optionale Felder werden nicht mitgesendet. Ihr Schlüssel wird hier als Parameter key gesendet, weil ein Formular keinen Header setzen kann; im Code verwenden Sie den Header X-API-Key. Alle Felder finden Sie in der Dokumentation.