API Dokumentation

Allgemeine Information

Information ein-/ausklappen

Die zugrundeliegenden Daten werden im Gemeindeverzeichnis automatisch mithilfe von Daten des Statistischen Bundesamts aktualisiert. Die Stichtage der Aktualisierung sind 01.01., 01.04., 01.07. und 01.10., zu denen das Statistische Bundesamt neue Daten bereitstellt. Mehr erfahren

Die API nimmt Payloads in Form von GET-Parametern an und liefert immer JSON-Objekte zurück. Andere Datenformate werden nicht unterstützt.

Antworten der API-Routen erfolgen bei üblicher Serverlast mit einer durchschnittlichen Antwortzeit von 100 ms. Die Generierung von Antwort-Objekten zu Anfragen an die API garantiert eine Antwortzeit von < 1000 ms, bevor ein Timeout durch das anfragende System angenommen werden kann.

Wir übernehmen keine Zusicherung zur Erreichbarkeit, Verfügbarkeit und Korrektheit sowie keinen technischen Support zu dieser API. Sie dürfen die API nach eigenem Ermessen und auf eigene Gefahr nutzen. Bitte beachten Sie, dass wir Zugriffe auf die API nicht limitieren. Bitte überlegen Sie sich eine angemessene und vertretbare Anfragenstrategie, vor allem wie häufig Sie Anfragen stellen, damit auch andere weiterhin Antworten erhalten können.

Datenformate

Alle ein-/ausklappen

AdministrativeDivision

Die regionale und politische Gliederung der Kommunen in Deutschland ist in dieser Entität einheitlich abgelegt. Jede Entität der regionalen und politischen Gliederung besitzt eine eindeutige Relation zu AdministrativeDivision.

Grafische Darstellung aus Wikipedia: https://commons.wikimedia.org/wiki/File:Administrative_divisions_of_Germany.svg

Die zurückgegebene Bezeichnung ist eine aus:

JSON-Format:

{
    'label': string,
    'explanation': string,
}

Beispiel:

{
    "label": "Kreis",
    "explanation": ""
}

Beispiel (2):

{
    "label": "Gemeindeverband",
    "explanation": "Erl\u00e4uterung der K\u00fcrzel: Land 08 Baden-W\u00fcrttemberg: VVG=Vereinbarte Verwaltungsgemeinschaft; GVV=Gemeinde Verwaltungsverband; Land 09 Bayern: Vgem=Verwaltungsgemeinschaft"
}

AdministrativeDivisionLabel

Über die Relation AdministrativeDivision hinweg besitzen Kreise, Gemeindeverbände und Gemeinden oftmals andere Bezeichnungen. Beispielsweise ist die Bezeichnung für Hannover "Stadt" und nicht "Gemeinde".

Die zurückgegebene Bezeichnung ist eine aus:

Liegt kein AdministrativeDivisionLabel vor, wird als Fallback die Bezeichnung der zugehörigen Relation AdministrativeDivision kopiert.

Einzelfallspezifische Bezeichnungen werden nicht mit diesem Datentyp abgebildet.

JSON-Format:

{
    'label': string,
    'explanation': string,
}

Beispiel:

{
    "label": "Kreisfreie Stadt",
    "explanation": ""
}

ARS

Amtlicher Regionalschlüssel (ARS): Definition (externer Link)

Amtlicher Gemeindeschlüssel (AGS): Definition (externer Link)

Die gerendete, gekürzte Schreibweise 03241 bedeutet, dass es sich um den Kreis 41 im Bundesland 03 handelt. Die kreiszugehörigen Gemeinden besitzen einen ARS, der auch mit derselben Kennung anfängt. Die JSON-Repräsentation umfasst die in die Bedeutung aufgeteilten Inhalte und der vorgerendete Gesamtstring im ARS-Format, und AGS-Format.

JSON-Format:

{
    'federalStateKey': string,
    'governmentalDistrictKey': string,
    'districtKey': string,
    'collectiveMunicipalityKey': string,
    'municipalityKey': string,
    'ars': string,
    'ags': string
}

Beispiel:

{
    "federalStateKey": "03",
    "governmentalDistrictKey": "2",
    "districtKey": "41",
    "collectiveMunicipalityKey": "0001",
    "municipalityKey": "001",
    "ars": "032410001001",
    "ags": "03241001"
}

CollectiveMunicipality

CollectiveMunicipalities bilden den AdminstrativeDivision-Typ Gemeindeverband ab.

JSON-Format:

{
    'uuid': UUID,
    'ars': ARS,
    'administrativeDivision': AdministrativeDivision,
    'administrativeDivisionLabel': AdministrativeDivisionLabel,
    'name': string,
    'districtUuid': UUID,
    'municipalityUuids': [UUID...]
}

Beispiel:

{
    "uuid": "dea683d1-ca45-4af0-bd6e-7df62d275c17",
    "ars": {
        "federalStateKey": "03",
        "governmentalDistrictKey": "4",
        "districtKey": "59",
        "collectiveMunicipalityKey": "5402",
        "municipalityKey": "",
        "ars": "034595402",
        "ags": "034595402"
    },
    "administrativeDivision": {
        "label": "Gemeindeverband",
        "explanation": "Erl\u00e4uterung der K\u00fcrzel: Land 08 Baden-W\u00fcrttemberg: VVG=Vereinbarte Verwaltungsgemeinschaft; GVV=Gemeinde Verwaltungsverband; Land 09 Bayern: Vgem=Verwaltungsgemeinschaft"
    },
    "administrativeDivisionLabel": {
        "label": "Samtgemeinde",
        "explanation": ""
    },
    "name": "Bersenbr\u00fcck",
    "districtUuid": "38cf9f08-cc23-42f2-90f9-1078689f4a4f",
    "municipalityUuids": [
        "5caa2bd7-e701-4673-b1c6-3089c50f8f6b",
        "bfa52988-ef42-472b-a916-87d195b6b825",
        "0235c63d-7d44-42d9-9012-39eb1150039d",
        "23acfdc6-38f7-40c5-a80c-2628d72d89eb",
        "10af2b3a-a17f-4af3-bdd3-50ec8b07eeaf",
        "fb4bd872-c558-4be6-b59c-8892a269dcbd",
        "f40ca554-4eff-4a76-84ec-1022e864dbc4"
    ]
}

District

Districts bilden den AdminstrativeDivision-Typ Kreis ab.

JSON-Format:

{
    'uuid': UUID,
    'ars': ARS,
    'administrativeDivision': AdministrativeDivision,
    'administrativeDivisionLabel': AdministrativeDivisionLabel,
    'customAdministrativeDivisionLabel': string,
    'name': string,
    'federalStateUuid': UUID,
    'governmentalDistrictUuid': UUID,
    'collectiveMunicipalityUuids': [UUID...],
    'municipalityUuids': [UUID...]
}

Beispiel:

{
    "uuid": "8fff4d44-fa3f-4cce-bfc6-1eb24adae202",
    "ars": {
        "federalStateKey": "03",
        "governmentalDistrictKey": "1",
        "districtKey": "51",
        "collectiveMunicipalityKey": "",
        "municipalityKey": "",
        "ars": "03151",
        "ags": "03151"
    },
    "administrativeDivision": {
        "label": "Kreis",
        "explanation": ""
    },
    "administrativeDivisionLabel": {
        "label": "Landkreis",
        "explanation": ""
    },
    "customAdministrativeDivisionLabel": "",
    "name": "Gifhorn",
    "federalStateUuid": "3a28b491-2ff4-4280-9b12-8bc7d37baf72",
    "governmentalDistrictUuid": "9362dc17-9dcf-4683-82b7-045c1625a967",
    "collectiveMunicipalityUuids": [
        "74479fc6-35bc-49bd-b464-0134541a66c6",
        "a346a5c3-c3c0-437d-a4f1-412751321cee",
        "a6ca8fc5-c54c-477b-a0be-4a70c296c163",
        "5368863e-df92-4a0c-848b-0b6eb702a946",
        "d507367a-ef4f-4dc6-9741-3b4190035023",
        "dd2a795c-9681-4a38-925c-a9c39e923e6f",
        "0f05e082-94b9-474d-a6ea-e87181f66335",
        "3e3a859b-97d9-411f-be27-83b6bb841255",
        "c5884375-d790-4b64-a064-d8ae76a9591b",
        "19d77814-c74d-45a7-99ce-d19208260802",
        "18c2cd4d-4364-4e24-b28e-0176f683ea83"
    ],
    "municipalityUuids": [
        "15068768-369b-4c7c-bf7a-6ea096543739",
        "3069f7d3-afeb-4639-93c8-ac7090c465b3",
        "ce9eda9f-bff8-4464-b5c4-c8eeb45ff10d",
        "37a3102b-baf2-41a8-bda8-74b0016104f0",
        "9b2145ef-95ba-4b90-9a0f-754bd4c2fffd",
        "a28c2ffb-d0d7-4e80-b4b6-3b005e1f661e",
        "67903b50-c2d4-479b-89e1-bd9569987441",
        "5f253bec-9353-4e01-8096-4825ed788088",
        "951c01f9-7d6c-4362-81cb-5687dd2c4216",
        "1cd023db-6743-4021-8e78-356e4605ac29",
        "bd599307-bd66-4c98-b670-36d2550b79b4",
        "622b1d90-17b0-4a57-b973-fa465c0d3ac0",
        "f3edf75c-605c-4948-9b89-bd8d1ffa5d73",
        "f365383a-5949-4bbe-8545-c8cfb83b6ac7",
        "a3b2c0a6-7771-405f-ba11-8eccc52c3c48",
        "215893bc-6b4e-43b8-98ba-2a1ded771c86",
        "4db4aaf7-b835-4685-8d4e-7ce18178e59a",
        "85e1304d-6d1f-4f30-afcb-d8fe926b14c1",
        "89ce4bb3-f813-4495-b448-9912c4a1c7e3",
        "1cd77619-f156-4699-b133-79bf46ad9c33",
        "39768419-1bd9-4855-8dbf-ea84468b4cec",
        "88b34b86-b60d-4ac7-98ae-1787bd1013fe",
        "c792e522-2772-49da-b674-2e7dde389706",
        "97d9a37f-e9cd-4954-981c-f3b35ead158a",
        "3b10daac-16e9-41a4-a606-5c366962a5fa",
        "cb36904e-4eaf-4278-bc27-906a9d41ead6",
        "91194a3d-ceb0-448a-a186-747b04174bc7",
        "1bf6a02c-758e-422f-b875-64e7c1a654c0",
        "3e89dfe3-efc4-426b-b6db-2ed2779b2ec4",
        "16fa1d6d-0d07-4cd3-a12e-0ecc3cf16e41",
        "22d83c7e-8617-451b-b299-df2835fcbd32",
        "f222e8e0-1986-4817-a227-1cf04447ba17",
        "e292bb1a-a4a8-41ff-b6c8-3e96a6fe2a2f",
        "e40dec73-1f7b-476a-b371-dfd4f2fb05b4",
        "79ddf99c-f265-4bc0-a307-0c3b0530bbb9",
        "582ee08d-bc1f-4b6d-905b-cfe04814b0c2",
        "49532420-8f4d-4439-94e7-d0e9a65a5398",
        "98d2b198-e752-42cd-b0bf-02c5abed3f62",
        "0c6d398a-9298-444d-afc9-1abdf704fcff",
        "ce23e310-3600-48a9-8ad1-2f67df09369b",
        "448f3ba8-3e68-4df0-a413-bd96293a9aec",
        "ae847471-f761-475f-8af2-616594f34230"
    ]
}

FederalState

FederalStates bilden den AdminstrativeDivision-Typ Land ab.

JSON-Format:

{
    'uuid': UUID,
    'ars': ARS,
    'administrativeDivision': AdministrativeDivision,
    'name': string,
    'governmentalDistrictUuids': [UUID...],
    'districtUuids': [UUID...]
}

Beispiel:

{
    "uuid": "3a28b491-2ff4-4280-9b12-8bc7d37baf72",
    "ars": {
        "federalStateKey": "03",
        "governmentalDistrictKey": "",
        "districtKey": "",
        "collectiveMunicipalityKey": "",
        "municipalityKey": "",
        "ars": "03",
        "ags": "03"
    },
    "administrativeDivision": {
        "label": "Land",
        "explanation": ""
    },
    "name": "Niedersachsen",
    "governmentalDistrictUuids": [
        "9362dc17-9dcf-4683-82b7-045c1625a967",
        "899acfea-4a1f-45f1-98ef-51b7aa4cefbb",
        "3759881b-09f0-47ed-9ddd-cb818d5df11e",
        "b167cceb-3073-4962-9b33-12d186fac292"
    ],
    "districtUuids": [
        "9b08ec91-da91-4ae5-84cc-a9f5749a949c",
        "b885dd97-7048-47dc-9f90-461483866d49",
        "621f9f0c-1ffa-4191-a1a7-fe5b3ba878f6",
        "8fff4d44-fa3f-4cce-bfc6-1eb24adae202",
        "826a7929-f285-4b7f-b08d-5d8dcfcc0bb8",
        "d369dd09-4c6f-4d5a-91c7-3e0fcb0928a3",
        "e5ae5c45-65f8-432f-9a22-bf9cdb9e6492",
        "808a47b8-2aa9-4772-9c83-be62c6669678",
        "1438d198-2c7b-4801-b8a2-428fd2b28caf",
        "664ef640-e05d-4dd2-b8f9-717279962133",
        "4cb0b366-df80-4796-a36d-5afba180372d",
        "ea10d702-d550-4e3f-b48a-32752f8f27e0",
        "16b9c08f-29c8-42d4-bedc-0b830deb7759",
        "1e57c729-e68e-431c-9d30-25b3d49914c0",
        "3237af94-db6e-4b83-9723-b14f1e6511f2",
        "82a5c74b-eaa8-404c-a3f4-1f84995185c2",
        "5d74589f-bf14-4240-9df3-3947260a5eca",
        "fbac20da-40b2-4ef2-9554-04cb97c1fd0d",
        "f1dd0528-6930-411f-8c6d-97b5d4b3cbe1",
        "51fff744-2068-4621-a4c6-a1101749ec3a",
        "806209fd-a599-4516-9619-be339d6b65ca",
        "c91a791a-54bb-4830-be03-bd391ee1588f",
        "0c87dd22-ef83-4a1f-a982-d6738d28e4a2",
        "12ce60a0-b080-4147-b17f-aa51fc404ef4",
        "372f3cdf-9a08-4a72-b001-35fe02a3d88a",
        "9fcb42d9-b561-4bc9-8d62-02d01d903096",
        "61eed13f-778b-4695-9960-c130b4e37b40",
        "50d88e7b-ad6e-4140-baf5-0f677f683fcb",
        "aea43797-4e4d-4c7f-b82e-51d5d2869983",
        "6d760bc2-021c-43ac-b8f3-d004a530769a",
        "14890134-8bf1-4454-b35d-bb7125fbca2c",
        "0e820ba2-ef8a-4a6d-afa0-f2926fa0d3ce",
        "6b7b7731-d8cd-4a6d-b644-cfc64db026dc",
        "a456d148-1aa5-4617-8d6b-6b52ee542c0a",
        "b51334f6-0905-47e1-a01a-0629a6adf5ac",
        "395b89bb-7bad-4e81-9565-009d56dea8a4",
        "9d6baf49-c650-4952-9d18-f21f3706452d",
        "d154dea5-9f57-45fa-9032-e7c9dd2a975c",
        "be1323fe-2cbf-44aa-b6a2-5f4889986d1d",
        "6b82764c-2e60-4186-b6ac-850d34e1516a",
        "c71f09ca-5790-4f0a-9f54-921855298a28",
        "38cf9f08-cc23-42f2-90f9-1078689f4a4f",
        "55bcfa69-9dfe-4df0-97be-8f9c47726317",
        "98e4b921-22c2-4a52-8e86-ceed9ebaf288",
        "f4787250-6b0c-42cf-9263-cea115e9561c"
    ]
}

GeoCoordinate

Geo-Koordinaten werden als Strings mit einer Genauigkeit von 6 Nachkommastellen als Gradangabe ausgegeben.

JSON-Format:

[0-9]{0,3}\.[0-9]{6}

Beispiel:

"52.374551"

GovernmentalDistrict

GovernmentalDistricts bilden die AdminstrativeDivision-Typen Regierungsbezirk und Region ab. Regionen gibt es nur in Baden-Württemberg und gehören zu einem Regierungsbezirk. Die Relation zwischen Regierungsbezirken und Regionen wird aus Gründen der Einheitlichkeit und Übersichtlichkeit des JSON-Objekts nicht ausgegeben. Stattdessen wird bei Regierungsbezirken mit Regionen das optionale Feld districtUuidsByDeepSearch ergänzt, dass die Kreise aller Regionen akkumuliert.

JSON-Format:

{
    'uuid': UUID,
    'ars': ARS,
    'administrativeDivision': AdministrativeDivision,
    'name': string,
    'federalStateUuid': UUID,
    'districtUuids': [UUID...],
    'districtUuidsByDeepSearch': [UUID...] /*optional*/
}

Beispiel:

{
    "uuid": "899acfea-4a1f-45f1-98ef-51b7aa4cefbb",
    "ars": {
        "federalStateKey": "03",
        "governmentalDistrictKey": "2",
        "districtKey": "",
        "collectiveMunicipalityKey": "",
        "municipalityKey": "",
        "ars": "032",
        "ags": "032"
    },
    "administrativeDivision": {
        "label": "Regierungsbezirk",
        "explanation": ""
    },
    "name": "Statistische Region Hannover",
    "federalStateUuid": "3a28b491-2ff4-4280-9b12-8bc7d37baf72",
    "districtUuids": [
        "4cb0b366-df80-4796-a36d-5afba180372d",
        "ea10d702-d550-4e3f-b48a-32752f8f27e0",
        "16b9c08f-29c8-42d4-bedc-0b830deb7759",
        "1e57c729-e68e-431c-9d30-25b3d49914c0",
        "3237af94-db6e-4b83-9723-b14f1e6511f2",
        "82a5c74b-eaa8-404c-a3f4-1f84995185c2",
        "5d74589f-bf14-4240-9df3-3947260a5eca"
    ]
}

Municipality

Municipalities bilden den AdminstrativeDivision-Typ Gemeinde ab.

Die Fläche wird als Integer in Quadratmetern formatiert. Die Angabe populationPerSquareKM ist die gerundete Einwohnerzahl pro Quadratkilometer.

JSON-Format:

{
    'uuid': UUID,
    'ars': ARS,
    'administrativeDivision': AdministrativeDivision,
    'administrativeDivisionLabel': AdministrativeDivisionLabel,
    'customAdministrativeDivisionLabel': string,
    'name': string,
    'districtUuid': UUID,
    'collectiveMunicipalityUuid': UUID,
    'area': integer,
    'population': integer,
    'populationMale': integer,
    'populationFemale': integer,
    'populationPerSquareKM': integer,
    'longitude': GeoCoordinate,
    'latitude': GeoCoordinate,
    'zipCodeOfMainAdministration': ZipCode,
}

Beispiel:

{
    "uuid": "a267a3d0-43c3-4ec9-978c-b7cf73d53b01",
    "ars": {
        "federalStateKey": "03",
        "governmentalDistrictKey": "2",
        "districtKey": "41",
        "collectiveMunicipalityKey": "0001",
        "municipalityKey": "001",
        "ars": "032410001001",
        "ags": "03241001"
    },
    "administrativeDivision": {
        "label": "Gemeinde",
        "explanation": ""
    },
    "administrativeDivisionLabel": {
        "label": "Stadt",
        "explanation": ""
    },
    "customAdministrativeDivisionLabel": "Landeshauptstadt",
    "name": "Hannover",
    "districtUuid": "4cb0b366-df80-4796-a36d-5afba180372d",
    "collectiveMunicipalityUuid": "d357b63c-e7f7-493a-862b-ca5fe7fe2dcc",
    "area": 204300000,
    "population": 534049,
    "populationMale": 261124,
    "populationFemale": 272925,
    "populationPerSquareKM": 2614,
    "longitude": "52.374551",
    "latitude": "9.738084",
    "zipCodeOfMainAdministration": "30159"
}

UUID

In der API werden UUID v4 als eindeutige Schlüssel verwendet. Die API erwartet die ausführliche Schreibweise mit Bindestrichen.

JSON-Format:

[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}

Beispiel:

"a267a3d0-43c3-4ec9-978c-b7cf73d53b01"

ZipCode

Deutsche Postleitzahlen werden als String mit 5 Zahlen ausgegeben.

JSON-Format:

[0-9]{5}

Beispiel:

"30159"

Routen

Alle ein-/ausklappen

GET /api/read/{uuid}

Gibt das zur übergebenen UUID gefundenen Objekt aus den gespeicherten AdministrativeDivision-Daten aus.

Alle möglichen Ausgabeobjekte sind AdministrativeDivision-Typen und besitzen daher den Schlüssel administrativeDivision, anhand dessen das Datenformat festgemacht werden kann.

@param uuid UUID

@return FederalState|GovernmentalDistrict|District|CollectiveMunicipality|Municipality

@return [], wenn kein Objekt mit der übergebenen UUID gefunden wurde

Beispiel:

GET /api/read/a267a3d0-43c3-4ec9-978c-b7cf73d53b01

{
    "uuid": "a267a3d0-43c3-4ec9-978c-b7cf73d53b01",
    "ars": {
        "federalStateKey": "03",
        "governmentalDistrictKey": "2",
        "districtKey": "41",
        "collectiveMunicipalityKey": "0001",
        "municipalityKey": "001",
        "ars": "032410001001",
        "ags": "03241001"
    },
    "administrativeDivision": {
        "label": "Gemeinde",
        "explanation": ""
    },
    "administrativeDivisionLabel": {
        "label": "Stadt",
        "explanation": ""
    },
    "customAdministrativeDivisionLabel": "Landeshauptstadt",
    "name": "Hannover",
    "districtUuid": "4cb0b366-df80-4796-a36d-5afba180372d",
    "collectiveMunicipalityUuid": "d357b63c-e7f7-493a-862b-ca5fe7fe2dcc",
    "area": 204300000,
    "population": 534049,
    "populationMale": 261124,
    "populationFemale": 272925,
    "populationPerSquareKM": 2614,
    "longitude": "52.374551",
    "latitude": "9.738084",
    "zipCodeOfMainAdministration": "30159"
}

Beispiel (2):

GET /api/read/dea683d1-ca45-4af0-bd6e-7df62d275c17

{
    "uuid": "dea683d1-ca45-4af0-bd6e-7df62d275c17",
    "ars": {
        "federalStateKey": "03",
        "governmentalDistrictKey": "4",
        "districtKey": "59",
        "collectiveMunicipalityKey": "5402",
        "municipalityKey": "",
        "ars": "034595402",
        "ags": "034595402"
    },
    "administrativeDivision": {
        "label": "Gemeindeverband",
        "explanation": "Erl\u00e4uterung der K\u00fcrzel: Land 08 Baden-W\u00fcrttemberg: VVG=Vereinbarte Verwaltungsgemeinschaft; GVV=Gemeinde Verwaltungsverband; Land 09 Bayern: Vgem=Verwaltungsgemeinschaft"
    },
    "administrativeDivisionLabel": {
        "label": "Samtgemeinde",
        "explanation": ""
    },
    "name": "Bersenbr\u00fcck",
    "districtUuid": "38cf9f08-cc23-42f2-90f9-1078689f4a4f",
    "municipalityUuids": [
        "5caa2bd7-e701-4673-b1c6-3089c50f8f6b",
        "bfa52988-ef42-472b-a916-87d195b6b825",
        "0235c63d-7d44-42d9-9012-39eb1150039d",
        "23acfdc6-38f7-40c5-a80c-2628d72d89eb",
        "10af2b3a-a17f-4af3-bdd3-50ec8b07eeaf",
        "fb4bd872-c558-4be6-b59c-8892a269dcbd",
        "f40ca554-4eff-4a76-84ec-1022e864dbc4"
    ]
}

GET /api/search/{query}

Gibt eine Liste der zum übergebenen Suchwort gefundenen Objekte aus den gespeicherten AdministrativeDivision-Daten aus.

Das Suchwort kann im Format UUID, ARS, ARS.ags, ZipCode übergeben werden. Alle Objekte, die auf diese Suche exakt passen, nehmen Präferenz in den Suchergebnissen und die zugehörigen Daten werden als erstes ausgeliefert.

Das Suchwort wird als String in den Namen der Objekte exakt und anschließend mit einer Ähnlichkeitsheuristik gesucht. Umlaute wie ä, ö, ü werden mit den ähnlichen Buchstaben a, o, u gematcht. Die Groß- und Kleinschreibung ist nicht relevant.

Mehrere Suchwörter (beispielsweise durch Leerzeichen getrennt) werden als exakter Gesamtstring im Namen der Objekte gesucht. Ein Aufteilen in mehrere Suchwörter und Akkumulation von Suchergebnissen findet dabei nicht statt.

@param query Suchwort

@return [(FederalState|GovernmentalDistrict|District|CollectiveMunicipality|Municipality)...]

@return [], wenn kein Objekt gefunden wurde

Beispiel:

GET /api/search/hannover

[
    {
        "uuid": "a267a3d0-43c3-4ec9-978c-b7cf73d53b01",
        "ars": {
            "federalStateKey": "03",
            "governmentalDistrictKey": "2",
            "districtKey": "41",
            "collectiveMunicipalityKey": "0001",
            "municipalityKey": "001",
            "ars": "032410001001",
            "ags": "03241001"
        },
        "administrativeDivision": {
            "label": "Gemeinde",
            "explanation": ""
        },
        "administrativeDivisionLabel": {
            "label": "Stadt",
            "explanation": ""
        },
        "customAdministrativeDivisionLabel": "Landeshauptstadt",
        "name": "Hannover",
        "districtUuid": "4cb0b366-df80-4796-a36d-5afba180372d",
        "collectiveMunicipalityUuid": "d357b63c-e7f7-493a-862b-ca5fe7fe2dcc",
        "area": 204300000,
        "population": 534049,
        "populationMale": 261124,
        "populationFemale": 272925,
        "populationPerSquareKM": 2614,
        "longitude": "52.374551",
        "latitude": "9.738084",
        "zipCodeOfMainAdministration": "30159"
    },
    {
        "uuid": "899acfea-4a1f-45f1-98ef-51b7aa4cefbb",
        "ars": {
            "federalStateKey": "03",
            "governmentalDistrictKey": "2",
            "districtKey": "",
            "collectiveMunicipalityKey": "",
            "municipalityKey": "",
            "ars": "032",
            "ags": "032"
        },
        "administrativeDivision": {
            "label": "Regierungsbezirk",
            "explanation": ""
        },
        "name": "Statistische Region Hannover",
        "federalStateUuid": "3a28b491-2ff4-4280-9b12-8bc7d37baf72",
        "districtUuids": [
            "4cb0b366-df80-4796-a36d-5afba180372d",
            "ea10d702-d550-4e3f-b48a-32752f8f27e0",
            "16b9c08f-29c8-42d4-bedc-0b830deb7759",
            "1e57c729-e68e-431c-9d30-25b3d49914c0",
            "3237af94-db6e-4b83-9723-b14f1e6511f2",
            "82a5c74b-eaa8-404c-a3f4-1f84995185c2",
            "5d74589f-bf14-4240-9df3-3947260a5eca"
        ]
    },
    {
        "uuid": "4cb0b366-df80-4796-a36d-5afba180372d",
        "ars": {
            "federalStateKey": "03",
            "governmentalDistrictKey": "2",
            "districtKey": "41",
            "collectiveMunicipalityKey": "",
            "municipalityKey": "",
            "ars": "03241",
            "ags": "03241"
        },
        "administrativeDivision": {
            "label": "Kreis",
            "explanation": ""
        },
        "administrativeDivisionLabel": {
            "label": "Landkreis",
            "explanation": ""
        },
        "customAdministrativeDivisionLabel": "",
        "name": "Region Hannover",
        "federalStateUuid": "3a28b491-2ff4-4280-9b12-8bc7d37baf72",
        "governmentalDistrictUuid": "899acfea-4a1f-45f1-98ef-51b7aa4cefbb",
        "collectiveMunicipalityUuids": [
            "d357b63c-e7f7-493a-862b-ca5fe7fe2dcc",
            "37588d7b-8bbc-4a05-ab17-b2858543fb40",
            "932b6d14-e2cd-45d9-8ef3-52ea119e9ba4",
            "f5e5c1fb-15a2-4842-a074-d820a565f878",
            "1258ea77-f6a4-4743-8b16-4d501a4a350d",
            "57baf3d0-686e-4e02-bf27-201d00abadb9",
            "1bd0ff21-7f4d-4ae6-b916-2a2b2794e7a5",
            "cf195a4a-0f6b-46aa-a694-b3a5c07cfd48",
            "73b888c5-9531-491c-a9b8-9a98def50852",
            "74c0e232-3bce-4857-b5a7-05c98ae920e2",
            "6294163f-0671-4733-96ad-c2979981536e",
            "f11e1fc9-906a-4b41-beb2-f62bdf32328a",
            "b81d1d6e-b875-4fa6-ae59-79a03a6d2ad5",
            "60f56f66-8ee6-4efa-a57e-99118c65134d",
            "339c1a2a-a8bc-4258-ba07-56cf1ad19f90",
            "8521c465-d632-4403-ac70-c6d2f87c8430",
            "cef91688-686c-4b07-9d3a-61c5e6a00776",
            "b21e883f-badc-4758-97cf-51a9bc59f01b",
            "dcda9b7d-eb0e-4a0c-b806-a62dafbf5d76",
            "b61e280d-28c5-416b-852f-27305a8f407d",
            "94448223-0b83-4ab5-b4a6-ad92789f3eae"
        ],
        "municipalityUuids": [
            "a267a3d0-43c3-4ec9-978c-b7cf73d53b01",
            "31221a1f-625f-4aa3-9736-ec3f7cf7b570",
            "21638600-7977-421f-a412-8d7cba03cf09",
            "b6327e5e-8f2d-40e6-8d51-04bffaecb59b",
            "b73af216-c7e8-4d46-84d7-e418217abcef",
            "36500a7f-6d25-4c38-99ef-60e51a44c956",
            "dca5ff4c-43d1-4e47-9c24-b0c9ed368371",
            "78c87b2c-ca23-444d-ac05-bee666ab7b31",
            "076caebb-ae25-48c7-a430-94f5982479d5",
            "b2af917b-6183-4685-9006-6a1c2ae28ddd",
            "c4b0bf76-9bc6-47b3-9266-8850e4b80512",
            "12c3c2ef-9c91-4ad6-b7b1-307b1e7a214c",
            "f4784930-e38d-426d-a10c-b1e32db28aff",
            "531e82ad-89fa-4d8a-9f3b-9fb5e4c9892e",
            "d2e1476d-a508-497b-81d5-bf15d6b1999a",
            "027d1182-3b25-44c6-870a-e015521b69a4",
            "2f3beb06-fcc1-4bcd-99c7-ba3e95993c88",
            "f8e07c16-ad09-4e9f-a345-501260bbad42",
            "567e01f2-fbc1-476b-9b73-91a65668ec13",
            "26e48c18-24de-4202-939c-188d8118532b",
            "cd90bc1c-5faa-4451-bdb2-5bbd268821ac"
        ]
    },
    {
        "uuid": "d357b63c-e7f7-493a-862b-ca5fe7fe2dcc",
        "ars": {
            "federalStateKey": "03",
            "governmentalDistrictKey": "2",
            "districtKey": "41",
            "collectiveMunicipalityKey": "0001",
            "municipalityKey": "",
            "ars": "032410001",
            "ags": "032410001"
        },
        "administrativeDivision": {
            "label": "Gemeindeverband",
            "explanation": "Erläuterung der Kürzel: Land 08 Baden-Württemberg: VVG=Vereinbarte Verwaltungsgemeinschaft; GVV=Gemeinde Verwaltungsverband; Land 09 Bayern: Vgem=Verwaltungsgemeinschaft"
        },
        "administrativeDivisionLabel": {
            "label": "Gemeindeverband",
            "explanation": "Erläuterung der Kürzel: Land 08 Baden-Württemberg: VVG=Vereinbarte Verwaltungsgemeinschaft; GVV=Gemeinde Verwaltungsverband; Land 09 Bayern: Vgem=Verwaltungsgemeinschaft"
        },
        "name": "Hannover, Landeshauptstadt",
        "districtUuid": "4cb0b366-df80-4796-a36d-5afba180372d",
        "municipalityUuids": [
            "a267a3d0-43c3-4ec9-978c-b7cf73d53b01"
        ]
    },
    {
        "uuid": "a267a3d0-43c3-4ec9-978c-b7cf73d53b01",
        "ars": {
            "federalStateKey": "03",
            "governmentalDistrictKey": "2",
            "districtKey": "41",
            "collectiveMunicipalityKey": "0001",
            "municipalityKey": "001",
            "ars": "032410001001",
            "ags": "03241001"
        },
        "administrativeDivision": {
            "label": "Gemeinde",
            "explanation": ""
        },
        "administrativeDivisionLabel": {
            "label": "Stadt",
            "explanation": ""
        },
        "customAdministrativeDivisionLabel": "Landeshauptstadt",
        "name": "Hannover",
        "districtUuid": "4cb0b366-df80-4796-a36d-5afba180372d",
        "collectiveMunicipalityUuid": "d357b63c-e7f7-493a-862b-ca5fe7fe2dcc",
        "area": 204300000,
        "population": 534049,
        "populationMale": 261124,
        "populationFemale": 272925,
        "populationPerSquareKM": 2614,
        "longitude": "52.374551",
        "latitude": "9.738084",
        "zipCodeOfMainAdministration": "30159"
    }
]