Der Deutschlandatlas ist ein Internetangebot, herausgegeben vom Bundesministerium für Wohnen, Stadtentwicklung und Bauwesen. Dort finden sich interaktive Karten zu gleichwertigen Lebensverhältnissen auf Grundlage aktueller verfügbarer Daten. Informationen zu allen Indikatoren sowie aktuelle Daten in tabellarischer Form stehen online zum Download bereit.

Im JSON-Format lassen sich aktuelle und historische Daten zu ausgewählten Indikatoren über GET-requests folgender Machart erhalten:

https://www.karto365.de/hosting/rest/services/{table}/MapServer/0/query?f=json&where=1%3D1&outFields=*&returnGeometry=false

Dabei ist {table} der Name der angefragten Tabelle (z.B. p_apo_f_ZA2022).

Angaben zu allen online vorliegenden Tabellen (vgl. hier und hier) und den zentralen enthaltenen Daten (sog. "outFields") finden sich in folgender Tabelle.

Weitere Parameter finden sich unter der Tabelle aufgelistet und erläutert.

Die Werte aller Parameter müssen URL-codiert sein wie im Beispiel unten verdeutlicht (also z.B. "where=1%3D1" statt "where=1=1"). Weitere Informationen zu den Parametern finden sich hier

Parameter where Eine WHERE-Klausel für den query-filter. z.B. "1=1"

Parameter f Das Antwortformat. Standardantwortformat ist html. z.B. "html", "json", "kmz", "geojson", pbf" (vgl. hier)

Parameter outFields Die Liste der Variablen (fields), die in die zurückgegebene Ergebnismenge aufgenommen werden sollen. Diese Liste ist eine durch Kommas getrennte Liste von Variablennamen. Als Wert dieses Parameters können Sie auch den Platzhalter "*" angeben. In diesem Fall enthalten die Abfrageergebnisse alle Feldwerte.

Parameter returnGeometry Bei "true" enthält das Ergebnis die Geometrie, die jedem zurückgegebenen Feature zugeordnet ist. Die Voreinstellung ist true. z.B. "false"

Parameter geometry Die Geometrie, die als räumlicher Filter angewendet werden soll. Die Struktur der Geometrie entspricht der Struktur der JSON-Geometrieobjekte, die von der ArcGIS-REST-API zurückgegeben werden. Zusätzlich zu den JSON-Strukturen können Sie die Geometrie von Envelopes und Punkten mit einer einfachen kommagetrennten Syntax angeben. z.B.

• geometryType=esriGeometryEnvelope&geometry={xmin: -104, ymin: 35.6, xmax: -94.32, ymax: 41}
• geometryType=esriGeometryEnvelope&geometry=-104,35.6,-94.32,41
• geometryType=esriGeometryPoint&geometry=-104,35.6

Parameter geometryType Der vom Geometrieparameter angegebene Geometrietyp. Der Geometrietyp kann ein Envelope, ein Punkt, eine Linie oder ein Polygon sein. Der Standardgeometrietyp ist ein Envelope. z.B. "esriGeometryEnvelope", "esriGeometryPoint", "esriGeometryMultipoint", "esriGeometryPolyline", "esriGeometryPolygon"

Parameter inSR Der Raumbezug (spatial reference) der Eingabegeometrie. Der Raumbezug kann entweder als bekannte ID oder als Raumbezugs-JSON-Objekt angegeben werden. Wenn inSR nicht angegeben ist, wird davon ausgegangen, dass sich die Geometrie im Raumbezug des Layers befindet.

Parameter outSR Der Raumbezug (spatial reference) der zurückgegebenen Geometrie. Der Raumbezug kann entweder als bekannte ID oder als Raumbezugs-JSON-Objekt angegeben werden. Wenn outSR nicht angegeben ist, wird die Geometrie im Raumbezug der Karte zurückgegeben. Bei Verwendung von outSR mit pbf verwendet das pbf-Format die Koordinatenquantisierung für layer-queries. Wenn für einen Abfragevorgang kein Ausgaberaumbezug bereitgestellt wird, leitet der Feature-Service Koordinatenquantisierungsparameter aus dem Raumbezug des Layers ab. Wenn die Genauigkeit des Raumbezugs des Layers für die Verwendung durch die Client-Anwendung nicht ausreicht, sollte sie einen Raumbezug mit angemessener Genauigkeit als Ausgabe-Raumbezug übergeben. Wenn der Quell-Raumbezug des Layers die gewünschte Genauigkeit aufweist und für die Verwendung durch den Client geeignet ist, kann der Client den Raumbezug des Quell-Layers als Ausgabe-Raumbezug verwenden.

Parameter objectIds Die abzufragenden Objekt-IDs dieses layer oder dieser Tabelle.

Parameter spatialRel Die räumliche Beziehung, die beim Ausführen des Query auf die Eingabegeometrie angewendet werden soll. Zu den unterstützten räumlichen Beziehungen gehören Schnittmenge, Enthält, Envelope-Schnittmenge, Innerhalb usw. Die standardmäßige räumliche Beziehung ist Schnittmenge (esriSpatialRelIntersects). z.B. "esriSpatialRelIntersects", "esriSpatialRelContains", "esriSpatialRelCrosses", "esriSpatialRelEnvelopeIntersects", "esriSpatialRelIndexIntersects","esriSpatialRelOverlaps","esriSpatialRelTouches","esriSpatialRelWithin"

Parameter distance Der Pufferabstand für die Eingabegeometrien. Die Entfernungseinheit wird durch Einheiten angegeben. Wenn die Entfernung beispielsweise 100 beträgt, ist die Abfragegeometrie ein Punkt, die Einheiten werden auf Meter festgelegt, und alle Punkte innerhalb von 100 Metern um den Punkt werden zurückgegeben. Der geodätische Puffer wird basierend auf dem Datum des ausgegebenen Raumbezugs erstellt, sofern vorhanden. Wenn kein Ausgaberaumbezug vorhanden ist, wird der Raumbezug der Eingabegeometrie verwendet. Andernfalls wird der Raumbezug des nativen Layers verwendet, um den in der Abfrage verwendeten Geometriepuffer zu generieren. Dieser Parameter gilt nur, wenn supportsQueryWithDistance true ist. z.B. 100

Parameter units Die Einheit zur Berechnung des Pufferabstands. Wenn keine Einheit angegeben ist, lautet der Standardwert esriSRUnit_Foot beim Abfragen von Feature-Services in ArcGIS Enterprise und esriSRUnit_Meter beim Abfragen von Feature-Services in ArcGIS Online. Dieser Parameter gilt nur, wenn supportsQueryWithDistance true ist. z.B. "esriSRUnit_Foot", "esriSRUnit_Meter" , "esriSRUnit_StatuteMile", "esriSRUnit_Kilometer", "esriSRUnit_NauticalMile", "esriSRUnit_USNauticalMile"

Parameter relationParam Die räumliche Beziehungsfunktion, die beim Ausführen des Abfragevorgangs angewendet werden kann. Ein Beispiel für diese räumliche Beziehungsfunktion ist "FFFTTT***".

Parameter maxAllowableOffset Diese Option kann verwendet werden, um den maxAllowableOffset anzugeben, der zum Generalisieren von Geometrien verwendet werden soll, die von der Query-Operation zurückgegeben werden. Der maxAllowableOffset wird in den Einheiten von outSR angegeben. Wenn outSR nicht angegeben ist, wird davon ausgegangen, dass maxAllowableOffset in der Einheit des Raumbezugs der Karte vorliegt. z.B. 2

Parameter geometryPrecision Diese Option kann verwendet werden, um die Anzahl der Dezimalstellen in den Antwortgeometrien anzugeben, die von der Query-Operation zurückgegeben werden. Dies gilt nur für x- und y-Werte (nicht für m- oder z-Werte). z.B. 3

Parameter havingClause Diese Option ist eine mit outStatistics verwendete Bedingung, die das Query-Ergebnis auf Gruppen beschränkt, die die verwendete Aggregationsfunktion erfüllen. Der Parameter havingClause wird mit den Parametern groupBy und outStatistics verwendet und ermöglicht das Filtern von Ergebnissen aus outStatistics. Dieser Parameter gilt nur, wenn die Eigenschaft supportsHavingClause des layer true ist.

Parameter returnIdsOnly Wenn true, enthält die Antwort nur ein Array von Objekt-IDs. Andernfalls ist die Antwort ein Funktionssatz. Der Standardwert ist false. Wenn Objekt-IDs angegeben sind, ist es ungültig, diesen Parameter auf "true" zu setzen. Während die Anzahl der Features in der Feature-Set-Antwort begrenzt ist, gibt es keine Begrenzung für die Anzahl der Objekt-IDs, die in der ID-Array-Antwort zurückgegeben werden. Clients können dies ausnutzen, um alle abfragekonformen Objekt-IDs zu erhalten, indem sie returnIdsOnly=true angeben und anschließend Feature-Sets für Teilmengen von Objekt-IDs anfordern. z.B. "false"

Parameter returnCountOnly Wenn "true", enthält die Antwort nur die Anzahl (Anzahl der Merkmale/Datensätze), die von einer Abfrage zurückgegeben würde. Andernfalls ist die Antwort ein Feature set. Der Standardwert ist false. Diese Option ersetzt den Parameter returnIdsOnly. Wenn returnCountOnly = true ist, gibt die Antwort sowohl die Anzahl als auch den Umfang zurück. Dieser Parameter kann mit returnDistinctValues ​​verwendet werden, um die Anzahl unterschiedlicher Werte von Teilfeldern zurückzugeben. z.B. "false"

Parameter orderByFields Ein oder mehrere Variablen-/field-Namen, nach denen die Features/Datensätze geordnet werden sollen. Verwenden Sie ASC oder DESC für aufsteigend bzw. absteigend, nach jedem field, um die Reihenfolge zu steuern. orderByFields ist standardmäßig ASC (aufsteigende Reihenfolge), wenn nicht angegeben ist. orderByFields wird nur auf den Ebenen/Tabellen unterstützt, die angeben, dass supportsAdvancedQueries true ist.

Parameter groupByFieldsForStatistics Ein oder mehrere Variablen-/field-Namen, nach denen die Werte für die Berechnung der Statistik gruppiert werden sollen. groupByFieldsForStatistics ist nur gültig, wenn der outStatistics-Parameter verwendet wird.

Parameter outStatistics Die Definitionen für eine oder mehrere zu berechnende feldbasierte Statistiken. Dieser Parameter wird nur für Layers/Tabellen unterstützt, die angeben, dass supportsStatistics true ist. Bei Verwendung von outStatistics sind die einzigen anderen Parameter, die verwendet werden können, groupByFieldsForStatistics, orderByFields, time und where.

Parameter returnZ Bei "true" werden Z-Werte in die Ergebnisse aufgenommen, wenn die Features Z-Werte aufweisen. Andernfalls werden keine Z-Werte zurückgegeben. Der Standardwert ist false. Dieser Parameter gilt nur, wenn returnGeometry true ist und die hasZ-Eigenschaft des Layers true ist. z.B. "false"

Parameter returnM Bei "true" werden M-Werte in die Ergebnisse aufgenommen, wenn die Features M-Werte aufweisen. Andernfalls werden keine M-Werte zurückgegeben. Der Standardwert ist false. Dieser Parameter gilt nur, wenn returnGeometry true ist und die hasM-Eigenschaft der Ebene true ist. z.B. "false"

Parameter gdbVersion Die abzufragende Geodatabase-Version. Dieser Parameter gilt nur, wenn die isDataVersioned-Eigenschaft der Ebene wahr ist. Wenn dies nicht angegeben ist, bezieht sich die Abfrage auf die Version der veröffentlichten Karte. z.B. SDE.DEFAULT

Parameter historicMoment Dies ist der historische Moment, den es mit dem Query anzufragen gilt. Dieser Parameter gilt nur, wenn für den Layer die Archivierung aktiviert ist und die Eigenschaft supportsQueryWithHistoricMoment auf "true" gesetzt ist. Diese Eigenschaft wird in der Layer-Ressource bereitgestellt. Wenn HistoricMoment nicht angegeben ist, gilt die Abfrage für die aktuellen Features. z.B. 1199145600000

Parameter returnDistinctValues Bei "true" werden unterschiedliche Werte basierend auf den in outFields angegebenen Feldern zurückgegeben. Dieser Parameter gilt nur, wenn die Eigenschaft supportsAdvancedQueries der Ebene true ist. Dieser Parameter kann mit returnCountOnly verwendet werden, um die Anzahl unterschiedlicher Werte von Teilfeldern zurückzugeben. Stellen Sie sicher, dass Sie returnGeometry auf false setzen, wenn returnDistinctValues ​​true ist. Andernfalls werden keine zuverlässigen Ergebnisse zurückgegeben. z.B. "false"

Parameter resultOffset Diese Option kann zum Abrufen von Abfrageergebnissen verwendet werden, indem die angegebene Anzahl von Datensätzen übersprungen und beim nächsten Datensatz (d. h. resultOffset + 1) begonnen wird. Der Standardwert ist 0. Dieser Parameter gilt nur, wenn supportsPagination wahr ist. Sie können diese Option verwenden, um Datensätze abzurufen, die über maxRecordCount hinausgehen. z.B. 100

Parameter resultRecordCount Diese Option kann zum Abrufen von Query-Ergebnissen bis zum angegebenen resultRecordCount verwendet werden. Wenn resultOffset angegeben ist, dieser Parameter jedoch nicht, setzt der Karten-Service standardmäßig maxRecordCount ein. Der Höchstwert für diesen Parameter ist der Wert der maxRecordCount-Eigenschaft des layer. Der für diesen Parameter eingegebene Mindestwert darf nicht kleiner als 1 sein. Dieser Parameter gilt nur, wenn supportsPagination true ist. z.B. 10

Parameter returnExtentOnly Bei "true" enthält die Antwort nur die Ausdehnung der Features, die von der Abfrage zurückgegeben würden. Wenn returnCountOnly=true, gibt die Antwort sowohl die Anzahl als auch den Umfang zurück. Der Standardwert ist false. Dieser Parameter gilt nur, wenn die Eigenschaft supportsReturningQueryExtent der Ebene true ist. z.B. "false"

Parameter sqlFormat Der sqlFormat-Parameter kann entweder der Standard-SQL-92-Standard sein oder das native SQL des zugrunde liegenden nativen Datenspeichers verwenden. Der Standardwert ist none, was bedeutet, dass das sqlFormat vom useStandardizedQuery-Parameter abhängt. z.B. "none", "standard", "native"

Parameter datumTransformation Dieser Parameter wendet eine Datumstransformation an, während Geometrien in den Ergebnissen projiziert werden, wenn sich outSR vom Raumbezug des Layers unterscheidet. Beim Festlegen von Transformationen müssen Sie überlegen, welche Datumstransformation den Layer (nicht den Feature-Service) am besten auf die Eigenschaft outSR und sourceSpatialReference im Layer-Ressourcenbericht projiziert.

Parameter quantizationParameters Dies ist ein JSON-Objekt, das verwendet wird, um die Geometrie auf ein virtuelles Gitter zu projizieren, das wahrscheinlich Pixel auf dem Bildschirm darstellt. Zu den Eigenschaften des JSON-Objekts gehören Ausdehnung, Modus, Ursprungsposition und Toleranz.

Parameter featureEncoding ... z.B. "esriDefault"

Parameter timeRelation ... z.B. "esriTimeRelationOverlaps"

Parameter returnTrueCurves ... z.B. "false"

Parameter text ...

Parameter time ...

Parameter parameterValues ...

Parameter rangeValues ...