GIS Cloud (Vorschau)
Mit diesem Connector können Benutzer jeden gültigen Autorisierungsschlüssel verwenden, der in GIS Cloud generiert wird, um auf eine Liste ihrer Kartenprojekte zuzugreifen, die in diesen Ebenen definierten Ebenen und die features, die auf diesen Ebenen enthalten sind. Um die dynamische Art des Featureschemas zu berücksichtigen, fragt der Connector den Dienst dynamisch für das Featureschema einer bestimmten Ebene ab.
Dieser Connector ist in den folgenden Produkten und Regionen verfügbar:
| Dienstleistung | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Logik-Apps | Norm | Alle Logik-Apps-Regionen mit Ausnahme der folgenden Bereiche: – Azure Government-Regionen - Azure China-Regionen - US Department of Defense (DoD) |
| Power Apps | Premium | Alle Power Apps-Regionen mit Ausnahme der folgenden: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Power Automate | Premium | Alle Power Automate-Regionen mit Ausnahme der folgenden Bereiche: - US Government (GCC) - US Government (GCC High) - China Cloud betrieben von 21Vianet - US Department of Defense (DoD) |
| Kontakt | |
|---|---|
| Name | GIS Cloud Premium-Support |
| URL | https://docs.giscloud.com/rest |
| premiumsupport@giscloud.com |
| Connectormetadaten | |
|---|---|
| Herausgeber | HandyGeo-Lösungen |
| Webseite | http://www.giscloud.com |
| Datenschutzrichtlinie | https://www.giscloud.com/privacy-policy/ |
| Kategorien | Daten; Business Intelligence |
GIS Cloud ist eine SaaS-Plattform, die ein optimales Web- und mobiles Kartenrendering bietet, das mit einem leistungsstarken Formularmodul verbunden ist, um alle Ihre Anforderungen an die gemeinsame Zuordnung zu erleichtern. Der GIS Cloud Connector bietet eine Teilmenge der umfangreichen und leistungsstarken REST-API, mit der Automatisierungen die meisten gängigen Anwendungsfälle für ein Kartenprojekt steuern können. Mit diesem Connector können Sie FEATURES und Dateien auflisten, aktualisieren und interogaten. Mit dieser Teilmenge kann ein Benutzer viele datengesteuerte Aktivitäten automatisieren, z. B. das Erstellen neuer Features für die Inspektion, das Erstellen von Berichten, das Exportieren von Daten für dashboarding usw.
Voraussetzungen
Um den GIS Cloud Connector zu verwenden, müssen Sie über ein GIS Cloud-Benutzerkonto mit einem Karten-Editor-Abonnement verfügen, andernfalls funktionieren viele Aktionen nicht.
So erhalten Sie Anmeldeinformationen
Die GIS Cloud REST-API wird über einen API-Schlüssel gesichert. Die meisten REST-Endpunkte funktionieren nicht ohne einen gültigen API-Schlüssel.
Um einen gültigen API-Schlüssel zu erhalten, navigieren Sie zu https://manager.giscloud.com Ihrem GIS Cloud-Konto, und melden Sie sich an.
Klicken Sie oben rechts auf Ihren Benutzernamen, und wählen Sie im Dropdownmenü "Mein Konto" aus.
Wählen Sie im Popup modal die Registerkarte "API-Zugriff" aus. Geben Sie einen beschreibenden Namen für den Schlüssel in das Feld "Neue API-Schlüsselbeschreibung" ein, und klicken Sie auf "Schlüssel hinzufügen". Ein neuer modaler Schlüssel stellt Ihren neuen API-Schlüssel dar, den Sie sicher kopieren und speichern müssen, da er nie wieder angezeigt wird.
Weitere Informationen finden Sie unter: https://docs.giscloud.com/rest#creating-an-api-key
Nachdem dies abgeschlossen ist, können Sie den Connector erstellen und testen.
Erste Schritte mit Ihrem Connector
Beim ersten Einrichten des Connectors bestätigen Tests über die GetCurrentUser-Aktion, dass Ihr API-Schlüssel gültig ist, und gibt die Kontodetails zurück, die dem API-Schlüssel zugeordnet sind.
Die meisten Benutzer verwenden die Aktionen "GetFeatures", "CreateFeature", "UpdateFeature" und "DeleteFeature" in ihren Automatisierungen. Die anderen einbezogenen Aktionen werden hauptsächlich für die situationsspezifische Koordinierung eines bestimmten Automatisierungsszenarios verwendet.
Ein typisches Automatisierungsszenario besteht darin, GIS-Cloud-Features aus der SaaS-Datenbank in eine Dataverse-Tabelle oder ein Excel-Blatt zu synchronisieren, um ein Power BI-Dashboard zu erstellen. Je nach Ihrer Datenstruktur müssen Sie möglicherweise benutzerdefinierte Dataverse-Entitäten erstellen. Es wird empfohlen, dass eine Automatisierung den where Parameter in der GetFeatures-Aktion nutzt, um die in den letzten Tagen geänderten Features einzuschränken und nur diese zu synchronisieren. Dadurch wird die Leistung Ihrer Automatisierung optimiert.
Ein weiteres typisches Automatisierungsszenario besteht darin, neue GIS Cloud-Features automatisch basierend auf einer sekundären Datenquelle wie Dynamics, SalesForce, HTTP-Anforderungen oder sogar GIS Cloud selbst zu erstellen. Um dies zu erreichen, wird empfohlen, dass Benutzer sorgfältig überlegen, wie sie ihre sekundäre Datenquelle filtern, um die Featureerstellung auszulösen und ihr GIS Cloud-Zielebenenschema abgeschlossen zu haben, bevor die Automatisierung erstellt wird, da dies die Entwicklung vereinfacht.
Ein endgültiges typisches Automatisierungsszenario besteht darin, GIS Cloud-Features automatisch zu "archivieren", indem sie diejenigen kopieren, die bestimmte Kriterien erfüllen (d. h. einen bestimmten Status, der für eine Spalte festgelegt ist) in eine andere Ebene, und dann beim Erfolgreichen Löschen des ursprünglichen GIS Cloud-Features. Dadurch kann ein aktives Kartenprojekt visuell sauber gehalten werden, ohne dass kritische Daten verloren gehen.
Bekannte Probleme und Einschränkungen
Authentifizierungskompatibilität für PowerApps
Um die Kompatibilität mit der PCF-Kartenkomponente zu unterstützen, die von HandyGeo Services veröffentlicht wurde, und um zu vermeiden, dass PowerApps-Benutzer für API-Schlüssel auffordern, die nicht benutzerfreundliche sind, haben wir den Connector erstellt, damit der API-Schlüssel bei jeder Anforderung angegeben werden muss.
Dynamisches Datenschema für Featureendpunkte
Aufgrund geografischer Features in GIS Cloud, die von vom Benutzer hochgeladenen Daten stammen, ist das Schema immer datasetspezifisch. Das Schema für Nutzlasten und Antworten von allen Featureendpunkten ist immer dynamisch und erfordert Unterstützung für dynamische Schemas im verwendeten Office 365-Produkt. Dies wird in der Regel von PowerAutomate gut unterstützt, kann aber Herausforderungen in PowerApps darstellen.
Häufige Fehler und Abhilfemaßnahmen
Endpunkt-Paginierung
GIS Cloud-Endpunkte sind auf maximal 5.000 Datensätze beschränkt, die von einer einzigen Anforderung zurückgegeben werden. Während die REST-API die Paginierung unterstützt, gibt es derzeit keine Möglichkeit, dies automatisch in das Connectorverhalten einzuschließen.
REST-API-Ratenbeschränkung für Dienstschutz
Wie erwartet bei jedem Produktions-REST-API-Dienst, wenn eine übermäßige Anzahl von Anforderungen an die GIS-Cloud-API in kurzer Zeit erfolgt, ist die Antwort ein 5xx-Code. Während ein bestimmtes Zinslimit nicht explizit definiert ist, unterstützt die REST-API eine begrenzte parallele Schleifenrate (d. h. ca. 20), aber hohe Raten führen wahrscheinlich zu erheblichen Fehlern. Fehlerantworten können mit einer Wiederholungsrichtlinie verwaltet werden, aber übermäßige Raten verursachen Probleme.
Dynamisches Featuredatenschema fehlt
Da der Connector die Schemadefinition nachschlagen muss, kann die Aktion das Layerschema nicht zwischenspeichern, wenn die Parameter "Layer-ID" und/oder "API-Schlüssel" dynamisch übergeben werden. Dies erfordert, dass Benutzer den zurückgegebenen JSON-Code manuell verwalten müssen. Ersetzen Sie den dynamischen Parameter durch einen statischen Wert, indem Sie ihn in das Parameterfeld eingeben, und das Schema wird entsprechend zwischengespeichert.
Häufig gestellte Fragen
Die GetFeatures-Aktion gibt zu viele Features zurück, wie erhalte ich nur die gewünschten Features?
Es wird empfohlen, wenn möglich, dass Benutzer die Klausel nutzen, die where für die GetFeatures-Aktion verfügbar ist. Dies kann für die meisten SQL-kompatiblen WHERE Klauseln geeignet sein. Für Felder wie das von der Plattform verwaltete Änderungsdatum des Datensatzes wird empfohlen, dass Benutzer die GetColumns-Aktion testen, um den wahren logischen Namen der Systemspalten anzuzeigen.
Wie lade ich eine Datei in den Speicher von Kartenprojektbesitzern hoch, nicht in meinen eigenen Speicher?
Für die Aktion ist UploadFileToPath wichtig, dass, wenn der API-Schlüssel nicht für das Konto der Projektbesitzer zugeordnet ist, dass der Destination Map ID (destination_map) Parameter ausgefüllt ist. Dies signalisiert der GIS Cloud REST-API, dass die hochgeladene Datei nicht für den authentifizierten Benutzer, sondern für den Besitzer des angegebenen Kartenprojekts gilt. Wenn der Benutzer nicht über berechtigungen für den Zugriff auf die Karte verfügt, wird der Upload nicht an das Kartenschuldnerkonto weitergeleitet.
Drosselungsgrenzwerte
| Name | Aufrufe | Verlängerungszeitraum |
|---|---|---|
| API-Aufrufe pro Verbindung | 100 | 60 Sekunden |
Aktionen
| Abrufen aller Ebenen |
Ruft alle GIS Cloud Layer-Objekte ab. |
| Abrufen aller Ebenen auf einer Karte |
Rufen Sie alle Layerobjekte für ein einzelnes GIS Cloud Map-Objekt ab. |
| Abrufen einer Datei |
Laden Sie eine Datei aus GIS Cloud Storage herunter. |
| Abrufen einer Ebene |
Abrufen des gesamten GIS Cloud Layer-Objekts. |
| Abrufen einer Karte |
Ruft ein GIS Cloud Map-Objekt ab. |
| Abrufen eines vom Featurefeld abgelegten Mediums |
Dient zum Abrufen einer Mediendatei aus einem GIS Cloud Feature Object-Feld in einem Layer-Objekt. |
| Abrufen von Features auf einer Ebene |
Ruft alle GIS Cloud Feature-Objekte in einem Layer-Objekt ab. |
| Abrufen von Spalten für Layer |
Abrufen einer Liste von Spalten für eine Ebene |
| Aktualisieren einer Ebene |
Aktualisieren eines GIS Cloud Layer-Objekts. |
| Aktualisieren einer Karte |
Aktualisieren eines GIS Cloud Map-Projekts |
| Aktuelles Benutzerobjekt abrufen |
Abrufen des aktuellen GIS Cloud User-Objekts. |
| Alle Karten abrufen |
Ruft alle GIS Cloud Map-Objekte ab. |
| Benutzerobjekt nach ID abrufen |
Abrufen des GIS Cloud-Benutzerobjekts anhand der Benutzer-ID. |
| Entfernen einer Datei |
Entfernt eine Datei im GIS-Cloudspeicher. |
| Erstellen eines neuen Features auf einer Ebene |
Ruft alle GIS Cloud Feature-Objekte in einem Layer-Objekt ab. |
| Feature aktualisieren |
Aktualisieren eines GIS Cloud Feature-Objekts für ein Layer-Objekt. |
| Feature löschen |
Löscht das angegebene GIS Cloud-Featureobjekt aus der Ebene. |
| Funktion abrufen |
Ruft ein GIS Cloud Feature-Objekt für ein Layer-Objekt ab. |
| Hochladen einer Datei |
Lädt eine Datei in GIS Cloud Storage hoch. |
| Löschen einer Ebene |
Löschen Sie ein GIS Cloud Layer-Objekt. |
| Löschen einer Karte |
Löschen eines GIS-Cloudzuordnungsprojekts |
| Rendern einer Karte |
Rendern eines GIS Cloud Map-Objekts. |
| Zuordnungscache löschen |
Löscht den Cache der Kartenkachel, um Änderungen widerzuspiegeln, die über die API vorgenommen wurden. |
Abrufen aller Ebenen
Ruft alle GIS Cloud Layer-Objekte ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Attribute erweitern
|
expand | string |
Erweitern der Antwort um eine der Enumerationsoptionen |
|
|
Sichtbarkeitstyp
|
type | string |
Filtern nach Sichtbarkeit: 'öffentlich', 'privat', 'freigegeben' oder 'privat', freigegeben' |
|
|
Bestellung nach
|
order_by | string |
Dies muss auf Spalten verweisen, die im Gis Cloud-Zielobjekt vorhanden sind. Standardmäßig wird die Spalte "Acending" sortiert, aber auch :d esc umgekehrt die Reihenfolge. Sortieren nach, Format "{created|modified|created}:[asc|desc]" z.B. order_by=accessed:desc |
|
|
Elemente Per-Page
|
perpage | integer |
Anzahl der anzuzeigenden Ergebnisse pro Seite (Standard: 100, Maximum: 5000) |
|
|
Seite Nein
|
page | integer |
Seitenzahl für die Antwort |
|
|
Keine Summe
|
nototal | True | integer |
Die Summe der Ergebnisse wird nicht gezählt und angezeigt; verbessert die Reaktionszeit; wird verwendet, um die Antwort schneller zu erhalten |
Gibt zurück
- Body
- Layers
Abrufen aller Ebenen auf einer Karte
Rufen Sie alle Layerobjekte für ein einzelnes GIS Cloud Map-Objekt ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Karten-ID
|
map_id | True | integer |
Die interne Karten-ID, die zum Identifizieren einer bestimmten Karte verwendet wird |
|
Attribute erweitern
|
expand | string |
Erweitern der Antwort um eine der Enumerationsoptionen |
|
|
Bestellung nach
|
order_by | string |
Dies muss auf Spalten verweisen, die im Gis Cloud-Zielobjekt vorhanden sind. Standardmäßig wird die Spalte "Acending" sortiert, aber auch :d esc umgekehrt die Reihenfolge. Sortieren nach, Format "{created|modified|created}:[asc|desc]" z.B. order_by=accessed:desc |
|
|
Elemente Per-Page
|
perpage | integer |
Anzahl der anzuzeigenden Ergebnisse pro Seite (Standard: 100, Maximum: 5000) |
|
|
Seite Nein
|
page | integer |
Seitenzahl für die Antwort |
|
|
Keine Summe
|
nototal | integer |
Die Summe der Ergebnisse wird nicht gezählt und angezeigt; verbessert die Reaktionszeit; wird verwendet, um die Antwort schneller zu erhalten |
Gibt zurück
- Body
- Layers
Abrufen einer Datei
Laden Sie eine Datei aus GIS Cloud Storage herunter.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Pfad zur Datei
|
path_to_a_file | True | string |
Der relative Pfad zu einer bestimmten Datei |
|
Dateiname
|
file_name | True | string |
Name einer bestimmten Mediendatei, die auf den SaaS-Speicher schlaucht wird |
Gibt zurück
- response
- file
Abrufen einer Ebene
Abrufen des gesamten GIS Cloud Layer-Objekts.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Layer-ID
|
layer_id | True | integer |
Die interne Layer-ID, die zum Identifizieren einer bestimmten Ebene verwendet wird |
|
Attribute erweitern
|
expand | string |
Erweitern der Antwort um eine der Enumerationsoptionen |
Gibt zurück
- Body
- Layer
Abrufen einer Karte
Ruft ein GIS Cloud Map-Objekt ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Karten-ID
|
map_id | True | integer |
Die interne Karten-ID, die zum Identifizieren einer bestimmten Karte verwendet wird |
|
Attribute erweitern
|
expand | string |
Erweitern der Antwort um eine der Enumerationsoptionen |
Gibt zurück
- Body
- Map
Abrufen eines vom Featurefeld abgelegten Mediums
Dient zum Abrufen einer Mediendatei aus einem GIS Cloud Feature Object-Feld in einem Layer-Objekt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Datei herunterladen
|
download | boolean |
Sollte eine abgerufene Mediendatei direkt heruntergeladen werden |
|
|
Pfad zur Datei
|
path_to_a_file | True | string |
Der relative Pfad zu einer bestimmten Datei |
|
Feldname
|
field_name | True | string |
Name eines Featurefelds auf einer bestimmten Ebene |
|
Feature-ID
|
feature_id | True | integer |
Die interne Feature-ID, die zum Identifizieren eines bestimmten Features verwendet wird |
|
Layer-ID
|
layer_id | True | integer |
Die interne Layer-ID, die zum Identifizieren einer bestimmten Ebene verwendet wird |
Gibt zurück
- response
- file
Abrufen von Features auf einer Ebene
Ruft alle GIS Cloud Feature-Objekte in einem Layer-Objekt ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Layer-ID
|
layer_id | True | integer |
Die interne Layer-ID, die zum Identifizieren einer bestimmten Ebene verwendet wird |
|
Geometrie einschließen
|
geometry | string |
Format, in dem Geometrie verpackt wird. Mögliche Werte: 'wkt', 'kml' und 'gml' |
|
|
EPSG-Projektion
|
epsg | integer |
EPSG-Code für die Ausgabeprojektion. wenn keine angegebene Standardzuordnungsprojektion verwendet wird |
|
|
Räumliche Grenzen
|
bounds | string |
Begrenzungsfeld, das für die räumliche Filterung verwendet wird |
|
|
SQL Where
|
where | string |
SQL-Typ, der für die Attributfilterung verwendet wird |
|
|
Bestellung nach
|
order_by | string |
Dies muss auf Spalten verweisen, die im Gis Cloud-Zielobjekt vorhanden sind. Standardmäßig wird die Spalte "Acending" sortiert, aber auch :d esc umgekehrt die Reihenfolge. Sortieren nach, Format "{created|modified|created}:[asc|desc]" z.B. order_by=accessed:desc |
|
|
Elemente Per-Page
|
perpage | integer |
Anzahl der anzuzeigenden Ergebnisse pro Seite (Standard: 100, Maximum: 5000) |
|
|
Seite Nein
|
page | integer |
Seitenzahl für die Antwort |
|
|
Keine Summe
|
nototal | integer |
Die Summe der Ergebnisse wird nicht gezählt und angezeigt; verbessert die Reaktionszeit; wird verwendet, um die Antwort schneller zu erhalten |
Gibt zurück
Abrufen von Spalten für Layer
Abrufen einer Liste von Spalten für eine Ebene
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Layer-ID
|
layer_id | True | integer |
Die interne Layer-ID, die zum Identifizieren einer bestimmten Ebene verwendet wird |
Aktualisieren einer Ebene
Aktualisieren eines GIS Cloud Layer-Objekts.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Layer-ID
|
layer_id | True | integer |
Die interne Layer-ID, die zum Identifizieren einer bestimmten Ebene verwendet wird |
|
Name
|
name | string |
Layername |
Aktualisieren einer Karte
Aktualisieren eines GIS Cloud Map-Projekts
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Karten-ID
|
map_id | True | integer |
Die interne Karten-ID, die zum Identifizieren einer bestimmten Karte verwendet wird |
|
Name
|
name | string |
Kartenname |
Aktuelles Benutzerobjekt abrufen
Abrufen des aktuellen GIS Cloud User-Objekts.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Attribute erweitern
|
expand | string |
Erweitern der Antwort um eine der Enumerationsoptionen |
Gibt zurück
- Body
- User
Alle Karten abrufen
Ruft alle GIS Cloud Map-Objekte ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Sichtbarkeitstyp
|
type | string |
Filtern nach Sichtbarkeit: 'öffentlich', 'privat', 'freigegeben' oder 'privat', freigegeben' |
|
|
Attribute erweitern
|
expand | string |
Erweitern der Antwort um eine der Enumerationsoptionen |
|
|
Bestellung nach
|
order_by | string |
Dies muss auf Spalten verweisen, die im Gis Cloud-Zielobjekt vorhanden sind. Standardmäßig wird die Spalte "Acending" sortiert, aber auch :d esc umgekehrt die Reihenfolge. Sortieren nach, Format "{created|modified|created}:[asc|desc]" z.B. order_by=accessed:desc |
|
|
Elemente Per-Page
|
perpage | integer |
Anzahl der anzuzeigenden Ergebnisse pro Seite (Standard: 100, Maximum: 5000) |
|
|
Seite Nein
|
page | integer |
Seitenzahl für die Antwort |
|
|
Keine Summe
|
nototal | integer |
Die Summe der Ergebnisse wird nicht gezählt und angezeigt; verbessert die Reaktionszeit; wird verwendet, um die Antwort schneller zu erhalten |
Gibt zurück
- Body
- Maps
Benutzerobjekt nach ID abrufen
Abrufen des GIS Cloud-Benutzerobjekts anhand der Benutzer-ID.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Benutzer-ID
|
user_id | True | integer |
Die interne Benutzer-ID, die zum Identifizieren eines bestimmten Benutzers verwendet wird |
|
Attribute erweitern
|
expand | string |
Erweitern der Antwort um eine der Enumerationsoptionen |
Gibt zurück
- Body
- User
Entfernen einer Datei
Entfernt eine Datei im GIS-Cloudspeicher.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Dateiname
|
file_name | True | string |
Name einer bestimmten Mediendatei, die auf den SaaS-Speicher schlaucht wird |
|
Pfad zur Datei
|
path_to_a_file | True | string |
Der relative Pfad zu einer bestimmten Datei |
Erstellen eines neuen Features auf einer Ebene
Ruft alle GIS Cloud Feature-Objekte in einem Layer-Objekt ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Layer-ID
|
layer_id | True | integer |
Die interne Layer-ID, die zum Identifizieren einer bestimmten Ebene verwendet wird |
|
payload
|
payload | dynamic |
Daten, aus der ein neues Feature erstellt werden soll, werden alle leer gelassenen Elemente als NULL erstellt. |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
location
|
location | string |
Feature aktualisieren
Aktualisieren eines GIS Cloud Feature-Objekts für ein Layer-Objekt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Feature-ID
|
feature_id | True | integer |
Die interne Feature-ID, die zum Identifizieren eines bestimmten Features verwendet wird |
|
Layer-ID
|
layer_id | True | integer |
Die interne Layer-ID, die zum Identifizieren einer bestimmten Ebene verwendet wird |
|
payload
|
payload | dynamic |
Die neuen Featuredaten, die aktualisiert werden sollen |
Feature löschen
Löscht das angegebene GIS Cloud-Featureobjekt aus der Ebene.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Feature-ID
|
feature_id | True | integer |
Die interne Feature-ID, die zum Identifizieren eines bestimmten Features verwendet wird |
|
Layer-ID
|
layer_id | True | integer |
Die interne Layer-ID, die zum Identifizieren einer bestimmten Ebene verwendet wird |
Funktion abrufen
Ruft ein GIS Cloud Feature-Objekt für ein Layer-Objekt ab.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Feature-ID
|
feature_id | True | integer |
Die interne Feature-ID, die zum Identifizieren eines bestimmten Features verwendet wird |
|
Layer-ID
|
layer_id | True | integer |
Die interne Layer-ID, die zum Identifizieren einer bestimmten Ebene verwendet wird |
|
Geometrie einschließen
|
geometry | string |
Format, in dem Geometrie verpackt wird. Mögliche Werte: 'wkt', 'kml' und 'gml' |
|
|
EPSG-Projektion
|
epsg | integer |
EPSG-Code für die Ausgabeprojektion. wenn keine angegebene Standardzuordnungsprojektion verwendet wird |
Gibt zurück
Hochladen einer Datei
Lädt eine Datei in GIS Cloud Storage hoch.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Dateidaten
|
filedata | True | file |
Die hochzuladende Datei. |
|
Zielzuordnungs-ID
|
destination_map | integer |
Die Karten-ID der freigegebenen Karte. Wenn festgelegt, lädt die Datei zum Zuordnen des Besitzerspeichers hoch. |
|
|
Pfad zur Datei
|
path_to_a_file | True | string |
Der relative Pfad zu einer bestimmten Datei |
Gibt zurück
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
location
|
location | string |
Löschen einer Ebene
Löschen Sie ein GIS Cloud Layer-Objekt.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Layer-ID
|
layer_id | True | integer |
Die interne Layer-ID, die zum Identifizieren einer bestimmten Ebene verwendet wird |
Löschen einer Karte
Löschen eines GIS-Cloudzuordnungsprojekts
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Karten-ID
|
map_id | True | integer |
Die interne Karten-ID, die zum Identifizieren einer bestimmten Karte verwendet wird |
Rendern einer Karte
Rendern eines GIS Cloud Map-Objekts.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Karten-ID
|
map_id | True | integer |
Die interne Karten-ID, die zum Identifizieren einer bestimmten Karte verwendet wird |
|
Bildbreite
|
width | number |
Bildbreite in Pixeln |
|
|
Bildhöhe
|
height | number |
Bildhöhe in Pixel |
|
|
Cache ungültig
|
invalidate | number |
Cache ungültig |
|
|
Layerliste anzeigen
|
layerlist | number |
Layerliste auf sichtbar im Bild festlegen |
|
|
Gespeichertes Bild
|
justgenerate | number |
Generieren Sie einfach das Bild, ohne zu speichern. |
Gibt zurück
- response
- file
Zuordnungscache löschen
Löscht den Cache der Kartenkachel, um Änderungen widerzuspiegeln, die über die API vorgenommen wurden.
Parameter
| Name | Schlüssel | Erforderlich | Typ | Beschreibung |
|---|---|---|---|---|
|
API-Schlüssel
|
API-Key | True | password |
GIS-Cloud-API-Schlüssel, der zum Autorisieren des Vorgangs verwendet wird |
|
Karten-ID
|
map_id | True | integer |
Die interne Karten-ID, die zum Identifizieren einer bestimmten Karte verwendet wird |
|
Trigger erneut initialisieren
|
init_trigger | True | integer |
Sollte die Zuordnung vor dem Ausführen des Vorgangs erneut initialisiert werden |
|
Layerliste
|
layers | string |
CSV-Liste der einzuschließden Layer-IDs |
Definitionen
Maps
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Datensätze insgesamt
|
total | integer |
Gesamtanzahl der Datensätze, die abgerufen werden können |
|
Aktuelle Seite
|
page | integer |
Die Anzahl der zurückgegebenen Seite |
|
Objekte zuordnen
|
data | array of Map |
Array der zurückgegebenen Kartenobjekte |
Map
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Karten-ID
|
id | integer |
Interne ID dieser Karte |
|
Name
|
name | string |
Kartenname |
|
Owner-Objekt
|
owner | array of string |
Zuordnungsbesitzerobjekt. Dieser Wert wird nur angezeigt, wenn der Erweiterungsparameter den Schlüssel "owner" enthält. |
|
Active
|
active | string |
Ist die Karte aktiv |
|
Urheberrecht
|
copyright | string |
Copyright-Anweisungszeichenfolge |
|
Proj4
|
proj4 | string |
Proj4-Kartenprojektion |
|
Proj4-Einheiten
|
units_proj4 | string |
Einheiten der Proj4-Definition |
|
EPSG-Code
|
epsg | string |
EPSG-Kartenprojektionscode |
|
Karteneinheiten
|
units | string |
Karteneinheiten (Meter, Fuß oder foot_us) |
|
Max Zoom
|
maxzoom | string |
Maximaler Zoom |
|
Hintergrundfarbe
|
bgcolor | string |
Hintergrundfarbe der Karte |
|
Geändert am
|
modified | integer |
Zeitpunkt der letzten Änderung der Karte (UNIX-Zeitstempel) |
|
Zugriff auf
|
accessed | integer |
Zeitpunkt des letzten Zugriffs auf die Karte (UNIX-Zeitstempel) |
|
Erstellt unter
|
created | integer |
Zeitpunkt der Erstellung einer Karte (UNIX-Zeitstempel) |
|
Anzahl anzeigen
|
visited | string |
Anzahl der Kartenansichten |
|
Archived
|
archived | string |
Ist archiviert |
|
Ressourcen-ID
|
resource_id | string |
resource_id |
|
Maßeinheit
|
measure_unit | string |
measure_unit |
|
Sichtbar
|
visible | string |
sichtbar |
|
Resource-Objekt
|
resource | Resource |
Ressourcenobjekt zuordnen |
|
Description
|
description | string |
Kartenbeschreibung |
|
mobileacess
|
mobileacess | string |
mobileacess |
|
wmsaccess
|
wmsaccess | string |
wmsaccess |
|
Maptype
|
maptype | string |
Maptype |
|
assets
|
assets | string |
assets |
|
Bewertung
|
rating | string |
Bewertung |
|
Freigeben
|
share | string |
Freigeben |
|
Grenzen xMin
|
bounds.xmin | float |
xmin |
|
Bounds xMax
|
bounds.xmax | float |
xmax |
|
Begrenzungen yMin
|
bounds.ymin | float |
ymin |
|
Bounds yMax
|
bounds.ymax | float |
ymax |
|
gebunden
|
bound | string |
gebunden |
Resource
Ressourcenobjekt zuordnen
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Ressourcen-ID
|
id | integer |
Interne ID dieser Ressource |
|
Ressourcentyp
|
type | string |
Aufzählungstyp der Ressource |
|
Ressourcenspeicherort
|
location | string |
TBC mit potenziell NULL-Werten |
|
Ressourcen-ID
|
target_resource_id | string |
resource_id |
|
Ressourcenbesitzer-ID
|
owner_id | string |
Benutzer-ID des Benutzers, der diese Ressource besitzt |
|
Übergeordnete Ressourcen-ID
|
parent_id | string |
TBC mit potenziell NULL-Werten |
|
Abonnement-ID für Ressourcenzahlung
|
payment_subscription_id | string |
TBC mit potenziell NULL-Werten |
|
Ressourcenzahlungs-ID
|
payment_id | string |
TBC mit potenziell NULL-Werten |
|
Ressourcenzahlungs-ID Obs
|
payment_id_obs | string |
TBC mit potenziell NULL-Werten |
|
Archivierte Ressource
|
archived | string |
Gibt an, ob die Ressource archiviert wurde. |
|
Ressource deaktiviert
|
disabled | string |
TBC mit potenziell NULL-Werten |
|
Ressourcenzugriffszeit
|
access_time | object |
Zeitpunkt, zu dem zuletzt auf die Ressource zugegriffen wurde |
|
Geändert am
|
modified | integer |
Letzte Änderung der Ressource (UNIX-Zeitstempel) |
|
Erstellt unter
|
created | integer |
Zeitpunkt der Erstellung der Ressource (UNIX-Zeitstempel) |
Schichten
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Datensätze insgesamt
|
total | integer |
Gesamtanzahl der Datensätze, die abgerufen werden können |
|
Aktuelle Seite
|
page | integer |
Die Anzahl der zurückgegebenen Seite |
|
Layerobjekte
|
data | array of Layer |
Array von zurückgegebenen Layerobjekten |
Ebene
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Layer-ID
|
id | integer |
Die interne ID der Ebene |
|
Layername
|
name | string |
Benutzerdefinierter Layername |
|
Owner-Objekt
|
owner | array of string |
Layer owner object, EXPANDABLE |
|
Layerquelltyp
|
source.type | string |
Typ der bereitgestellten Daten |
|
Layerquell-URI
|
source.src | string |
URI-Zeichenfolge, die definiert, wo sich die Daten befinden |
|
OnScale
|
onscale | string |
Festlegen der Skalierung, auf der die Ebene sichtbar ist |
|
OffScale
|
offscale | string |
Festlegen der Skalierung, auf der die Ebene ausgeblendet ist |
|
Layerbezeichnung
|
label | string |
Attributname der Datenquelle, die für eine Zeilenbezeichnung verwendet werden soll |
|
x Min.
|
x_min | string |
Layergebundene X-Min-Koordinate |
|
x Max
|
x_max | string |
X max.-Koordinate der Ebene |
|
y Min.
|
y_min | string |
Layergebundene Y-Min-Koordinate |
|
y Max
|
y_max | string |
Layergebundene Y-Max-Koordinate |
|
Layertextfeld
|
textfield | string |
Attributname der Datenquelle, die als Textfeld verwendet werden soll |
|
Geändert am
|
modified | integer |
Zeitpunkt der letzten Änderung der Karte (UNIX-Zeitstempel) |
|
Erstellt unter
|
created | integer |
Zeitpunkt der Erstellung einer Karte (UNIX-Zeitstempel) |
|
Ebenenformatvorlagen
|
styles | string |
Komplexes Layerformatobjekt für die Ebenenformatvorlage |
|
Layer Alpha
|
alpha | string |
Layertransparenz |
|
Layer Datasource-Codierung
|
encoding | string |
Layer-Datenquellencodierung |
|
Seitenrand
|
margin | string |
Textfeldrand |
|
Layer-Sichtbarkeit
|
visible | string |
Steuert die Ebenensichtbarkeit, "nicht" oder "f" |
|
Layer gesperrt
|
lock | string |
Steuert layer interactivity, 't' oder 'f' |
|
Rasterebene
|
raster | string |
Layer ist eine Rasterdatenquelle, "nicht" oder "f" |
|
Layer exportierbar
|
exportable | string |
Legen Sie fest, ob die Ebene exportiert werden kann, 't' oder 'f' |
|
Zusammengeführte Ebene
|
merged | string |
Layer wird zusammengeführt |
|
Übergeordneter Layerordner
|
parent | string |
Übergeordnete Ordnerebenen-ID |
|
Layer-QuickInfo
|
tooltip | string |
QuickInfo, die auf den Layerfeatures angezeigt wird, mit dem Mauszeiger |
|
Geometrie ausblenden
|
hidegeometry | string |
Layergeometrie ausblenden. Kann nützlich sein, wenn nur Bezeichnungen angezeigt werden sollen, "nicht" oder "f" |
|
Info-Popup verwenden
|
use_info_window | string |
Anzeigen von Informationen zu Layerfeatures in einem Kartenpopup, "nicht" oder "f" |
|
Layer-Datenquelle-ID
|
datasource_id | string |
Datenquellen-ID der Layerdatenquelle |
|
Layer EPSG
|
epsg | string |
EPSG-Code für Datenquellen |
|
Layer geöffnet
|
opened | string |
Für ordnerebenen open/close booleschen Wert, 't' oder 'f' |
|
Layer-Ressourcen-ID
|
resource_id | string |
Ressourcen-ID der Ebene |
|
Layerzuordnungs-ID
|
map_id | string |
Zuordnungs-ID, zu der die Ebene gehört |
|
Layer-Geom-Typ
|
type | string |
Layergeometrietyp. Mögliche Werte sind "point", "line", "polygon", "tile" und "wms". |
|
Layerreihenfolge
|
order | integer |
Layer Z-Index |
|
Layer Options-Objekt
|
options | object |
Liste der optionen, die an diese Ressource gebunden sind. Dieser Wert wird nur angezeigt, wenn der Erweiterungsparameter den Schlüssel "options" enthält. |
|
Formularname
|
form.name | string |
Benutzerdefinierter Name des angefügten Formulars |
|
Layerformulardefinition
|
form.definition | string |
Definition des formulars, das der Ebene zugeordnet ist |
|
Datenquellenressourcen-Ressourcen-ID
|
datasource.resource_id | string |
Ressourcen-ID der Datenquelle |
|
Datenquellentyp
|
datasource.type | string |
Datenquellentyp für die Ebene |
|
Id des Datenquellenbesitzers
|
datasource.owner_id | string |
owner_id |
|
Erlaubnisse
|
datasource.permissions | array of string |
name |
|
Layerspaltenschema
|
columns | object |
Layerdatenquellenspalten anzeigen, EXPANDABLE |
|
Unterlayer
|
sublayers | array of Layer |
Array von Layer-Objekten, die in dieser Ebene geschachtelt sind |
Benutzer
| Name | Pfad | Typ | Beschreibung |
|---|---|---|---|
|
Benutzer-ID
|
id | integer |
Eindeutige Benutzer-ID |
|
Benutzertyp
|
type | string |
Angegebener Benutzertyp |
|
Benutzer aktiv
|
active | string |
Ist der Benutzer aktiv, 't' oder 'f' |
|
Nutzername
|
username | string |
Benutzername für Benutzer |
|
Vorname des Benutzers
|
firstname | string |
Vorname der Benutzer |
|
Nachname des Benutzers
|
lastname | string |
Nachname der Benutzer |
|
Benutzerbesitzer-ID
|
owner_id | string |
Benutzer-ID des Benutzers, der diesen Benutzer besitzt |
|
Benutzertelefon
|
phone | string |
Telefonnummer der Benutzer |
|
Mobile Benutzer
|
mobile | string |
Mobiltelefonnummer für Benutzer |
|
Erstellt unter
|
created | integer |
Zeitpunkt der Erstellung einer Karte (UNIX-Zeitstempel) |
|
Letzte Anmeldung
|
lastlog | integer |
Zeitpunkt der Erstellung einer Karte (UNIX-Zeitstempel) |
|
Benutzerunternehmen
|
company | string |
Firmenname der Benutzer |
|
Benutzerweb-URL
|
web | string |
Benutzerprofilwebsite |
|
Benutzer-E-Mail
|
string |
E-Mail-Adresse der Benutzer |
|
|
Benutzer-Avatar
|
avatar | string |
URL zum Abrufen des Avatars von Benutzern |
|
Benutzersprache
|
language | string |
Ausgewählte Sprache für Benutzer |
|
Anzahl der Dateifeatures
|
file_feature_count | string |
Anzahl der geografischen Features im Dateisystem |
|
DB-Featureanzahl
|
db_feature_count | string |
Anzahl der geografischen Features in der Datenbank |
|
Benutzerraster gespeichert
|
storage_raster | string |
Von Rasterkacheln verbrauchter Dateispeicher |
|
Speicherkapazität des Benutzers
|
storage_total | string |
Gesamtverbraucher Dateispeicher |
|
Grenzwert für Benutzerfeatures
|
feature_count_limit | string |
Anzahl der lizenzierten Features |
|
Benutzerrasterlimit
|
storage_raster_limit | string |
Lizenzierte maximale Speicherkapazität |
|
Abonnement beginnt
|
subscription_begins | string |
Wenn das Benutzerabonnement beginnt |
|
Abonnement läuft ab
|
subscription_expires | string |
Wenn das Benutzerabonnement endet |
|
Benutzerressourcen-ID
|
resource_id | string |
Interne Ressourcen-ID für diesen Benutzer |
|
Benutzer zuletzt geändert
|
modified | integer |
Datum der letzten Änderung (UNIX-Format) |
|
Benutzerorganisation
|
organization_id | string |
Organisations-ID für diesen Benutzer |
|
Benutzer-OIDC
|
oidc | string |
OpenID Connect |
|
Benutzeroptionen
|
options | string |
Liste der Optionen, die an den Benutzer gebunden sind. Dieser Wert wird nur angezeigt, wenn der Parameter "expand" den Schlüssel "options" enthält. |
|
Zustimmungen
|
consents | array of object |
Zustimmungsvereinbarungen für Benutzer |
|
Zustimmungszweck
|
consents.purpose | string |
Der Zweck der angeforderten Einwilligung |
|
Zustimmungsversion
|
consents.version | string |
Die Version der erteilten Zustimmung |
|
Zustimmung vereinbart
|
consents.agreed | string |
Wurde die Zustimmung erteilt |
file
Dies ist der grundlegende Datentyp "Datei".