Endpunkt `getgeocode`

Mit dem Endpunkt getgeocode können Sie mit einem beliebigen Textwert nach Geokoordinaten suchen.

https://app.{instanz}.via-cloud.de/api/geo/getgeocode?

Parameter

Parameter	Notwendig	Beschreibung
q	✅	Wenn normales Geocoding benutzt wird, ist dieser Parameter notwendig.Hier wird der Suchtext für die Adresse übergeben.Beispiel: Königsbrücker Str. 96/Haus 41, 01099 Dresden
locale		Sprache der ausgegebenen Suchergebnisse.Standard: de (deutsch)Verfügbar: fr (französisch), en (englisch), de (deutsch), it (italienisch)
limit		Anzahl der zurück gegebenen Ergebnisse. Standard: 5 Verfügbar: Integer
provider		Provider, welcher die Geocodierung übernehmen soll: • default • nominatim • opencagedata • gisgraphy Standard: default Hinweis: Die Preise können je nach Provider variieren.
api-key	✅	ihr API-Schlüssel ist für diese Schnittstelle immer notwendig.

Ergebnis

{
  "hits": [
    {
      "osm_id": 586710722,
      "extent": [
        13.7593205,
        51.080963,
        13.7603664,
        51.0798764
      ],
      "country": "Deutschland",
      "city": "Dresden",
      "postcode": "01099",
      "point": {
        "lng": 13.759985802512254,
        "lat": 51.08059885
      },
      "osm_type": "W",
      "osm_key": "building",
      "housenumber": "96",
      "street": "Königsbrücker Straße",
      "osm_value": "yes",
      "name": "Königsbrücker Straße",
      "state": "Sachsen"
    },
    {
      "osm_id": 586715535,
      "extent": [
        13.7606148,
        51.0813086,
        13.7610969,
        51.0810929
      ],
      "country": "Deutschland",
      "city": "Dresden",
      "postcode": "01099",
      "point": {
        "lng": 13.760862111835312,
        "lat": 51.08119925
      },
      "osm_type": "W",
      "osm_key": "building",
      "housenumber": "96",
      "street": "Königsbrücker Straße",
      "osm_value": "yes",
      "name": "Geb. 31",
      "state": "Sachsen"
    },
    {
      "osm_id": 636836622,
      "extent": [
        13.7605394,
        51.0801055,
        13.7608632,
        51.0799149
      ],
      "country": "Deutschland",
      "city": "Dresden",
      "postcode": "01099",
      "point": {
        "lng": 13.76070660103338,
        "lat": 51.08001675
      },
      "osm_type": "W",
      "osm_key": "building",
      "housenumber": "96",
      "street": "Königsbrücker Straße",
      "osm_value": "commercial",
      "name": "Halle 11",
      "state": "Sachsen"
    },
    {
      "osm_id": 586714843,
      "extent": [
        13.7603298,
        51.080861,
        13.7620709,
        51.0801887
      ],
      "country": "Deutschland",
      "city": "Dresden",
      "postcode": "01099",
      "point": {
        "lng": 13.761092882762707,
        "lat": 51.08056015
      },
      "osm_type": "W",
      "osm_key": "building",
      "housenumber": "96",
      "street": "Königsbrücker Straße",
      "osm_value": "yes",
      "name": "Halle 12",
      "state": "Sachsen"
    },
    {
      "osm_id": 4167137223,
      "osm_type": "N",
      "country": "Deutschland",
      "osm_key": "leisure",
      "housenumber": "96 Halle 8",
      "city": "Dresden",
      "street": "Königsbrücker Straße",
      "osm_value": "sports_centre",
      "postcode": "01099",
      "name": "Mandala Boulderhalle GmbH",
      "state": "Sachsen",
      "point": {
        "lng": 13.7601293,
        "lat": 51.0799639
      }
    }
  ],
  "took": 10
}

Text