GIS Cloud (wersja zapoznawcza)
Ten łącznik umożliwia użytkownikom używanie dowolnego prawidłowego klucza autoryzacji wygenerowanego w chmurze GIS w celu uzyskania dostępu do listy projektów map, warstw zdefiniowanych w programie i funkcji zawartych w tych warstwach. Aby dostosować się do dynamicznego charakteru schematu funkcji, łącznik będzie dynamicznie wykonywać zapytania dotyczące usługi dla schematu funkcji danej warstwy.
Ten łącznik jest dostępny w następujących produktach i regionach:
| Usługa | Class | Regions |
|---|---|---|
| Copilot Studio | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Logic Apps | Standard | Wszystkie regiony usługi Logic Apps z wyjątkiem następujących: — Regiony platformy Azure Government — Regiony platformy Azure (Chiny) - Departament Obrony USA (DoD) |
| Power Apps | Premium | Wszystkie regiony usługi Power Apps z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Power Automate | Premium | Wszystkie regiony usługi Power Automate z wyjątkiem następujących: - Rząd USA (GCC) - Rząd USA (GCC High) - China Cloud obsługiwane przez firmę 21Vianet - Departament Obrony USA (DoD) |
| Kontakt | |
|---|---|
| Name | Pomoc techniczna dla chmury GIS w warstwie Premium |
| adres URL | https://docs.giscloud.com/rest |
| premiumsupport@giscloud.com |
| Metadane łącznika | |
|---|---|
| Publisher | HandyGeo Solutions |
| Witryna internetowa | http://www.giscloud.com |
| Zasady ochrony prywatności | https://www.giscloud.com/privacy-policy/ |
| Kategorie | Dane; Analiza biznesowa |
GIS Cloud to platforma SaaS, która zapewnia najlepsze w klasie renderowanie map internetowych i mobilnych w połączeniu z zaawansowanym aparatem formularzy w celu ułatwienia wszystkich potrzeb związanych z mapowaniem współpracy. Łącznik GIS Cloud udostępnia podzbiór rozbudowanego i zaawansowanego interfejsu API REST, który umożliwia automatyzacjom obsługę większości typowych przypadków użycia projektu Mapy. Ten łącznik ułatwi wyświetlanie listy, aktualizowanie i przesłuchiwania map chmury GIS, warstw, użytkowników oraz tworzenia funkcji i plików. W tym podzestawie użytkownik może zautomatyzować wiele działań opartych na danych, takich jak tworzenie nowych funkcji do inspekcji, tworzenie raportów, eksportowanie danych do pulpitu nawigacyjnego itp.
Wymagania wstępne
Aby korzystać z łącznika GIS Cloud, musisz mieć konto użytkownika GIS Cloud z subskrypcją Edytora map. W przeciwnym razie wiele akcji nie będzie działać.
Jak uzyskać poświadczenia
Interfejs API REST chmury GIS jest zabezpieczony za pośrednictwem klucza interfejsu API. Większość punktów końcowych REST nie będzie działać bez prawidłowego klucza interfejsu API.
Aby uzyskać prawidłowy klucz interfejsu API, przejdź do https://manager.giscloud.com konta usługi GIS Cloud i zaloguj się do niej.
W prawym górnym rogu kliknij nazwę użytkownika i wybierz pozycję "Moje konto" z menu rozwijanego.
W okienku podręcznym wybierz kartę "Dostęp do interfejsu API". Wprowadź opisową nazwę klucza w polu "Nowy opis klucza interfejsu API" i kliknij pozycję "Dodaj klucz". Nowy modalny klucz interfejsu API będzie prezentował nowy klucz interfejsu API, który należy bezpiecznie skopiować i zapisać, ponieważ nigdy nie będzie wyświetlany ponownie.
Aby uzyskać dodatkowe informacje, zobacz: https://docs.giscloud.com/rest#creating-an-api-key
Po zakończeniu możesz utworzyć i przetestować łącznik.
Wprowadzenie do łącznika
Podczas pierwszej konfiguracji łącznika testowanie za pomocą akcji GetCurrentUser potwierdzi, że klucz interfejsu API jest prawidłowy i zwróci szczegóły konta skojarzone z kluczem interfejsu API.
Większość użytkowników będzie korzystać z akcji GetFeatures, CreateFeature, UpdateFeature i DeleteFeature w swoich automatyzacjach. Pozostałe uwzględnione działania będą używane głównie na potrzeby konkretnej koordynacji danego scenariusza automatyzacji.
Typowy scenariusz automatyzacji polega na synchronizowaniu funkcji chmury GIS z bazy danych SaaS z tabelą Dataverse lub arkuszem programu Excel na potrzeby tworzenia pulpitu nawigacyjnego usługi Power BI. W zależności od struktury danych może być konieczne utworzenie niestandardowych jednostek usługi Dataverse. Zaleca się, aby automatyzacja korzystała z parametru where w akcji GetFeatures, aby ograniczyć liczbę funkcji zmodyfikowanych w ciągu ostatnich kilku dni i zsynchronizować je tylko. Pozwoli to zoptymalizować wydajność automatyzacji.
Innym typowym scenariuszem automatyzacji jest automatyczne tworzenie nowych funkcji chmury GIS na podstawie pomocniczego źródła danych, takiego jak Dynamics, SalesForce, żądania HTTP, a nawet sama chmura GIS. Aby to osiągnąć, zaleca się, aby użytkownicy starannie rozważyli sposób filtrowania pomocniczego źródła danych w celu wyzwolenia tworzenia funkcji i sfinalizowania schematu warstwy docelowej GIS Cloud przed utworzeniem automatyzacji, ponieważ uprości to programowanie.
Ostatnim typowym scenariuszem automatyzacji jest automatyczne "archiwizowanie" funkcji chmury GIS przez skopiowanie tych, które spełniają określone kryteria (tj. określony stan ustawiony w kolumnie) na inną warstwę, a następnie pomyślne usunięcie oryginalnej funkcji chmury GIS. Dzięki temu aktywny projekt mapy może być wizualnie czysty bez utraty krytycznych danych.
Znane problemy i ograniczenia
Zgodność uwierzytelniania dla usługi PowerApps
Aby ułatwić zgodność ze składnikiem mapy PCF opublikowanym przez usługi HandyGeo Services i uniknąć monitowania użytkowników usługi PowerApps o klucze interfejsu API, które nie są przyjazne dla użytkownika, utworzyliśmy łącznik, aby wymagać określenia klucza interfejsu API przy każdym żądaniu.
Dynamiczny schemat danych dla punktów końcowych funkcji
Ze względu na funkcje geograficzne w chmurze GIS pochodzące z przekazanych przez użytkownika danych schemat jest zawsze specyficzny dla zestawu danych. W związku z tym schemat ładunków i odpowiedzi ze wszystkich punktów końcowych funkcji jest zawsze dynamiczny i wymaga obsługi schematów dynamicznych w używanym produkcie office 365. Jest to ogólnie dobrze obsługiwane przez usługę PowerAutomate, ale może stanowić wyzwanie w usłudze PowerApps.
Typowe błędy i środki zaradcze
Stronicowanie punktu końcowego
Punkty końcowe chmury GIS są ograniczone do maksymalnie 5000 rekordów zwracanych z jednego żądania. Chociaż interfejs API REST obsługuje stronicowanie, obecnie nie ma możliwości automatycznego uwzględnienia tego w zachowaniu łącznika.
Ograniczanie szybkości interfejsu API REST dla ochrony usługi
Zgodnie z oczekiwaniami w przypadku dowolnej produkcyjnej usługi interfejsu API REST, jeśli nadmierna liczba żądań do interfejsu API chmury GIS zostanie wykonana w krótkim czasie, odpowiedź będzie kodem 5xx. Chociaż określony limit szybkości nie jest jawnie zdefiniowany, interfejs API REST będzie obsługiwać ograniczoną szybkość pętli równoległej (tj. około 20), ale wysokie stawki mogą spowodować znaczne błędy. Odpowiedzi, które zakończyły się niepowodzeniem, można zarządzać za pomocą zasad ponawiania prób, ale nadmierne stawki spowodują problemy.
Brak schematu danych funkcji dynamicznych
Ze względu na to, że łącznik musi wyszukać definicję schematu, jeśli parametry identyfikatora warstwy i/lub klucza interfejsu API są przekazywane dynamicznie, akcja nie będzie mogła buforować schematu warstw, który będzie wymagał od użytkowników ręcznego zarządzania zwróconym kodem JSON. Zastąp parametr dynamiczny wartością statyczną, wpisując go w polu parametru, a schemat będzie odpowiednio buforowany.
Często zadawane pytania
Akcja GetFeatures zwraca zbyt wiele funkcji, jak mogę uzyskać tylko te, których chcę?
Zaleca się, aby użytkownicy korzystali z where klauzuli dostępnej w akcji GetFeatures. Może to obsłużyć większość klauzul zgodnych z WHERE programem SQL. W przypadku pól, takich jak data modyfikacji rekordu zarządzana przez platformę, zaleca się, aby użytkownicy testowali akcję GetColumns, aby wyświetlić prawdziwą nazwę logiczną kolumn systemowych.
Jak przekazać plik do magazynu Mapowanie właścicieli projektów, a nie do własnego magazynu?
W przypadku akcji PrzekażFileToPath ważne jest, aby jeśli klucz interfejsu API nie jest przeznaczony dla konta właścicieli projektu mapowania, że Destination Map ID (destination_map) parametr jest wypełniony. To sygnalizuje interfejs API REST chmury GIS, że przekazany plik nie jest przeznaczony dla uwierzytelnionego użytkownika, ale dla właściciela określonego projektu mapy. Jeśli użytkownik nie ma uprawnień dostępu do mapy, przekazywanie nie zostanie przekierowane do konta winnych mapy.
Limity ograniczania
| Nazwa | Wywołania | Okres odnowienia |
|---|---|---|
| Wywołania interfejsu API na połączenie | 100 | 60 sekund |
Akcje
| Aktualizowanie funkcji |
Zaktualizuj jeden obiekt funkcji chmury GIS na obiekcie warstwy. |
| Aktualizowanie jednej mapy |
Aktualizowanie jednego projektu mapy chmury GIS |
| Aktualizowanie jednej warstwy |
Zaktualizuj jeden obiekt warstwy chmury GIS. |
| Pobieranie bieżącego obiektu użytkownika |
Pobierz bieżący obiekt użytkownika chmury GIS. |
| Pobieranie funkcji w warstwie |
Pobierz wszystkie obiekty funkcji chmury GIS na obiekcie warstwy. |
| Pobieranie jednego pliku |
Pobierz jeden plik z magazynu GIS Cloud. |
| Pobieranie kolumn dla warstwy |
Pobieranie listy kolumn dla warstwy |
| Pobieranie nośnika z pola Funkcja |
Pobierz jeden plik multimedialny z pola obiekt funkcji chmury GIS w obiekcie warstwy. |
| Pobieranie obiektu użytkownika według identyfikatora |
Pobierz obiekt użytkownika chmury GIS według identyfikatora użytkownika. |
| Pobieranie wszystkich map |
Pobierz wszystkie obiekty mapy chmury GIS. |
| Pobieranie wszystkich warstw |
Pobierz wszystkie obiekty warstwy chmury GIS. |
| Pobieranie wszystkich warstw na mapie |
Pobierz wszystkie obiekty warstwy dla pojedynczego obiektu mapy chmury GIS. |
| Pobierz funkcję |
Pobierz jeden obiekt funkcji chmury GIS na obiekcie warstwy. |
| Pobierz jedną mapę |
Pobierz jeden obiekt mapy chmury GIS. |
| Przekazywanie jednego pliku |
Przekazuje plik do magazynu w chmurze GIS. |
| Renderuj jedną mapę |
Renderuj obraz przedstawiający jeden obiekt mapy chmury GIS. |
| Tworzenie nowej funkcji w warstwie |
Pobierz wszystkie obiekty funkcji chmury GIS na obiekcie warstwy. |
| Usuwanie pamięci podręcznej mapy |
Usuwa pamięć podręczną kafelka mapy w celu odzwierciedlenia zmian wprowadzonych za pośrednictwem interfejsu API. |
| Usuń funkcję |
Usuwa określony obiekt funkcji GIS Cloud z warstwy. |
| Usuń jeden plik |
Usuwa plik w magazynie GIS Cloud. |
| Usuń jedną mapę |
Usuwanie jednego projektu mapy chmury GIS |
| Usuń jedną warstwę |
Usuń jeden obiekt warstwy chmury GIS. |
| Uzyskiwanie jednej warstwy |
Pobierz cały obiekt warstwy chmury GIS. |
Aktualizowanie funkcji
Zaktualizuj jeden obiekt funkcji chmury GIS na obiekcie warstwy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator funkcji
|
feature_id | True | integer |
Wewnętrzny identyfikator funkcji używany do identyfikowania określonej funkcji |
|
Identyfikator warstwy
|
layer_id | True | integer |
Wewnętrzny identyfikator warstwy używany do identyfikowania określonej warstwy |
|
ładunek
|
payload | dynamic |
Nowe dane funkcji do zaktualizowania |
Aktualizowanie jednej mapy
Aktualizowanie jednego projektu mapy chmury GIS
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator mapy
|
map_id | True | integer |
Wewnętrzny identyfikator mapy używany do identyfikowania określonej mapy |
|
Name
|
name | string |
Nazwa mapy |
Aktualizowanie jednej warstwy
Zaktualizuj jeden obiekt warstwy chmury GIS.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator warstwy
|
layer_id | True | integer |
Wewnętrzny identyfikator warstwy używany do identyfikowania określonej warstwy |
|
Name
|
name | string |
Nazwa warstwy |
Pobieranie bieżącego obiektu użytkownika
Pobierz bieżący obiekt użytkownika chmury GIS.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Rozwiń atrybuty
|
expand | string |
Rozwiń odpowiedź według jednej z opcji wyliczenia |
Zwraca
- Body
- User
Pobieranie funkcji w warstwie
Pobierz wszystkie obiekty funkcji chmury GIS na obiekcie warstwy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator warstwy
|
layer_id | True | integer |
Wewnętrzny identyfikator warstwy używany do identyfikowania określonej warstwy |
|
Uwzględnij geometrię
|
geometry | string |
Format, w którym geometria zostanie spakowana. Możliwe wartości: "wkt", "kml" i "gml" |
|
|
Projekcja EPSG
|
epsg | integer |
Kod EPSG dla projekcji wyjściowej. Jeśli nie określono domyślnej projekcji mapy, zostanie użyta |
|
|
Granice przestrzenne
|
bounds | string |
Pole ograniczenia używane do filtrowania przestrzennego |
|
|
SQL Where
|
where | string |
Typ SQL where klauzula używana do filtrowania atrybutów |
|
|
Zamów według
|
order_by | string |
To musi odwoływać się do kolumn, które istnieją w docelowym obiekcie chmury GIS. Domyślnie kolumna jest sortowana, ale w tym :d esc odwraca kolejność. Kolejność według, format "{created|modified|created}:[asc|desc]" np. order_by=accessed:desc |
|
|
Elementy Per-Page
|
perpage | integer |
Liczba wyników na stronę do wyświetlenia (wartość domyślna: 100, maksymalna: 5000) |
|
|
Brak strony
|
page | integer |
Numer strony odpowiedzi |
|
|
Brak sumy
|
nototal | integer |
Łączna liczba wyników nie jest liczone i wyświetlane; poprawia czas odpowiedzi; służy do szybszego uzyskiwania odpowiedzi |
Zwraca
Pobieranie jednego pliku
Pobierz jeden plik z magazynu GIS Cloud.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Ścieżka do pliku
|
path_to_a_file | True | string |
Ścieżka względna do określonego pliku |
|
Nazwa pliku
|
file_name | True | string |
Nazwa określonego pliku nośnika wężowego w magazynie SaaS |
Zwraca
- response
- file
Pobieranie kolumn dla warstwy
Pobieranie listy kolumn dla warstwy
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator warstwy
|
layer_id | True | integer |
Wewnętrzny identyfikator warstwy używany do identyfikowania określonej warstwy |
Pobieranie nośnika z pola Funkcja
Pobierz jeden plik multimedialny z pola obiekt funkcji chmury GIS w obiekcie warstwy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Pobierz plik
|
download | boolean |
W przypadku bezpośredniego pobrania pobranego pliku multimedialnego |
|
|
Ścieżka do pliku
|
path_to_a_file | True | string |
Ścieżka względna do określonego pliku |
|
Nazwa pola
|
field_name | True | string |
Nazwa pola funkcji w danej warstwie |
|
Identyfikator funkcji
|
feature_id | True | integer |
Wewnętrzny identyfikator funkcji używany do identyfikowania określonej funkcji |
|
Identyfikator warstwy
|
layer_id | True | integer |
Wewnętrzny identyfikator warstwy używany do identyfikowania określonej warstwy |
Zwraca
- response
- file
Pobieranie obiektu użytkownika według identyfikatora
Pobierz obiekt użytkownika chmury GIS według identyfikatora użytkownika.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator użytkownika
|
user_id | True | integer |
Wewnętrzny identyfikator użytkownika używany do identyfikowania określonego użytkownika |
|
Rozwiń atrybuty
|
expand | string |
Rozwiń odpowiedź według jednej z opcji wyliczenia |
Zwraca
- Body
- User
Pobieranie wszystkich map
Pobierz wszystkie obiekty mapy chmury GIS.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Typ widoczności
|
type | string |
Filtruj według widoczności: "publiczny", "prywatny", "udostępniony" lub "prywatny", udostępniony |
|
|
Rozwiń atrybuty
|
expand | string |
Rozwiń odpowiedź według jednej z opcji wyliczenia |
|
|
Zamów według
|
order_by | string |
To musi odwoływać się do kolumn, które istnieją w docelowym obiekcie chmury GIS. Domyślnie kolumna jest sortowana, ale w tym :d esc odwraca kolejność. Kolejność według, format "{created|modified|created}:[asc|desc]" np. order_by=accessed:desc |
|
|
Elementy Per-Page
|
perpage | integer |
Liczba wyników na stronę do wyświetlenia (wartość domyślna: 100, maksymalna: 5000) |
|
|
Brak strony
|
page | integer |
Numer strony odpowiedzi |
|
|
Brak sumy
|
nototal | integer |
Łączna liczba wyników nie jest liczone i wyświetlane; poprawia czas odpowiedzi; służy do szybszego uzyskiwania odpowiedzi |
Zwraca
- Body
- Maps
Pobieranie wszystkich warstw
Pobierz wszystkie obiekty warstwy chmury GIS.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Rozwiń atrybuty
|
expand | string |
Rozwiń odpowiedź według jednej z opcji wyliczenia |
|
|
Typ widoczności
|
type | string |
Filtruj według widoczności: "publiczny", "prywatny", "udostępniony" lub "prywatny", udostępniony |
|
|
Zamów według
|
order_by | string |
To musi odwoływać się do kolumn, które istnieją w docelowym obiekcie chmury GIS. Domyślnie kolumna jest sortowana, ale w tym :d esc odwraca kolejność. Kolejność według, format "{created|modified|created}:[asc|desc]" np. order_by=accessed:desc |
|
|
Elementy Per-Page
|
perpage | integer |
Liczba wyników na stronę do wyświetlenia (wartość domyślna: 100, maksymalna: 5000) |
|
|
Brak strony
|
page | integer |
Numer strony odpowiedzi |
|
|
Brak sumy
|
nototal | True | integer |
Łączna liczba wyników nie jest liczone i wyświetlane; poprawia czas odpowiedzi; służy do szybszego uzyskiwania odpowiedzi |
Zwraca
- Body
- Layers
Pobieranie wszystkich warstw na mapie
Pobierz wszystkie obiekty warstwy dla pojedynczego obiektu mapy chmury GIS.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator mapy
|
map_id | True | integer |
Wewnętrzny identyfikator mapy używany do identyfikowania określonej mapy |
|
Rozwiń atrybuty
|
expand | string |
Rozwiń odpowiedź według jednej z opcji wyliczenia |
|
|
Zamów według
|
order_by | string |
To musi odwoływać się do kolumn, które istnieją w docelowym obiekcie chmury GIS. Domyślnie kolumna jest sortowana, ale w tym :d esc odwraca kolejność. Kolejność według, format "{created|modified|created}:[asc|desc]" np. order_by=accessed:desc |
|
|
Elementy Per-Page
|
perpage | integer |
Liczba wyników na stronę do wyświetlenia (wartość domyślna: 100, maksymalna: 5000) |
|
|
Brak strony
|
page | integer |
Numer strony odpowiedzi |
|
|
Brak sumy
|
nototal | integer |
Łączna liczba wyników nie jest liczone i wyświetlane; poprawia czas odpowiedzi; służy do szybszego uzyskiwania odpowiedzi |
Zwraca
- Body
- Layers
Pobierz funkcję
Pobierz jeden obiekt funkcji chmury GIS na obiekcie warstwy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator funkcji
|
feature_id | True | integer |
Wewnętrzny identyfikator funkcji używany do identyfikowania określonej funkcji |
|
Identyfikator warstwy
|
layer_id | True | integer |
Wewnętrzny identyfikator warstwy używany do identyfikowania określonej warstwy |
|
Uwzględnij geometrię
|
geometry | string |
Format, w którym geometria zostanie spakowana. Możliwe wartości: "wkt", "kml" i "gml" |
|
|
Projekcja EPSG
|
epsg | integer |
Kod EPSG dla projekcji wyjściowej. Jeśli nie określono domyślnej projekcji mapy, zostanie użyta |
Zwraca
Pobierz jedną mapę
Pobierz jeden obiekt mapy chmury GIS.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator mapy
|
map_id | True | integer |
Wewnętrzny identyfikator mapy używany do identyfikowania określonej mapy |
|
Rozwiń atrybuty
|
expand | string |
Rozwiń odpowiedź według jednej z opcji wyliczenia |
Zwraca
- Body
- Map
Przekazywanie jednego pliku
Przekazuje plik do magazynu w chmurze GIS.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Dane pliku
|
filedata | True | file |
Plik do przekazania. |
|
Identyfikator mapy docelowej
|
destination_map | integer |
Identyfikator mapy udostępnionej. W przypadku ustawienia plik jest przekazywany do magazynu właścicieli mapowania. |
|
|
Ścieżka do pliku
|
path_to_a_file | True | string |
Ścieżka względna do określonego pliku |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
lokalizacja
|
location | string |
Renderuj jedną mapę
Renderuj obraz przedstawiający jeden obiekt mapy chmury GIS.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator mapy
|
map_id | True | integer |
Wewnętrzny identyfikator mapy używany do identyfikowania określonej mapy |
|
Szerokość obrazu
|
width | number |
Szerokość obrazu w pikselach |
|
|
Wysokość obrazu
|
height | number |
Wysokość obrazu w pikselach |
|
|
Unieważnianie pamięci podręcznej
|
invalidate | number |
Unieważnianie pamięci podręcznej |
|
|
Pokaż listę warstw
|
layerlist | number |
Ustaw listę warstw na widoczną na obrazie |
|
|
Zapisany obraz
|
justgenerate | number |
Po prostu wygeneruj obraz bez zapisywania |
Zwraca
- response
- file
Tworzenie nowej funkcji w warstwie
Pobierz wszystkie obiekty funkcji chmury GIS na obiekcie warstwy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator warstwy
|
layer_id | True | integer |
Wewnętrzny identyfikator warstwy używany do identyfikowania określonej warstwy |
|
ładunek
|
payload | dynamic |
Dane do utworzenia nowej funkcji na podstawie wszystkich pozostałych elementów pustych zostaną utworzone jako null. |
Zwraca
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
lokalizacja
|
location | string |
Usuwanie pamięci podręcznej mapy
Usuwa pamięć podręczną kafelka mapy w celu odzwierciedlenia zmian wprowadzonych za pośrednictwem interfejsu API.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator mapy
|
map_id | True | integer |
Wewnętrzny identyfikator mapy używany do identyfikowania określonej mapy |
|
Ponowne inicjowanie wyzwalacza
|
init_trigger | True | integer |
W przypadku ponownego zainicjowania mapy przed wykonaniem operacji |
|
Lista warstw
|
layers | string |
Lista csv identyfikatorów warstw do uwzględnienia |
Usuń funkcję
Usuwa określony obiekt funkcji GIS Cloud z warstwy.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator funkcji
|
feature_id | True | integer |
Wewnętrzny identyfikator funkcji używany do identyfikowania określonej funkcji |
|
Identyfikator warstwy
|
layer_id | True | integer |
Wewnętrzny identyfikator warstwy używany do identyfikowania określonej warstwy |
Usuń jeden plik
Usuwa plik w magazynie GIS Cloud.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Nazwa pliku
|
file_name | True | string |
Nazwa określonego pliku nośnika wężowego w magazynie SaaS |
|
Ścieżka do pliku
|
path_to_a_file | True | string |
Ścieżka względna do określonego pliku |
Usuń jedną mapę
Usuwanie jednego projektu mapy chmury GIS
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator mapy
|
map_id | True | integer |
Wewnętrzny identyfikator mapy używany do identyfikowania określonej mapy |
Usuń jedną warstwę
Usuń jeden obiekt warstwy chmury GIS.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator warstwy
|
layer_id | True | integer |
Wewnętrzny identyfikator warstwy używany do identyfikowania określonej warstwy |
Uzyskiwanie jednej warstwy
Pobierz cały obiekt warstwy chmury GIS.
Parametry
| Nazwa | Klucz | Wymagane | Typ | Opis |
|---|---|---|---|---|
|
Klucz interfejsu API
|
API-Key | True | password |
Klucz interfejsu API chmury GIS używany do autoryzowania operacji |
|
Identyfikator warstwy
|
layer_id | True | integer |
Wewnętrzny identyfikator warstwy używany do identyfikowania określonej warstwy |
|
Rozwiń atrybuty
|
expand | string |
Rozwiń odpowiedź według jednej z opcji wyliczenia |
Zwraca
- Body
- Layer
Definicje
Maps
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Łączna liczba rekordów
|
total | integer |
Łączna liczba rekordów, które można pobrać |
|
Bieżąca strona
|
page | integer |
Liczba zwróconej strony |
|
Mapuj obiekty
|
data | array of Map |
Tablica zwracanych obiektów mapy |
Map
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator mapy
|
id | integer |
Wewnętrzny identyfikator tej mapy |
|
Name
|
name | string |
Nazwa mapy |
|
Obiekt właściciela
|
owner | array of string |
Mapuj obiekt właściciela. Ta wartość jest wyświetlana tylko wtedy, gdy parametr expand zawiera klucz "owner" |
|
Aktywna
|
active | string |
Czy mapa jest aktywna |
|
Prawo autorskie
|
copyright | string |
Ciąg oświadczenia o prawach autorskich |
|
Proj4
|
proj4 | string |
Projekcja mapy Proj4 |
|
Jednostki Proj4
|
units_proj4 | string |
Jednostki definicji Proj4 |
|
Kod EPSG
|
epsg | string |
Kod projekcji mapy EPSG |
|
Jednostki mapy
|
units | string |
Jednostki mapy (miernik, stopa lub foot_us) |
|
Maksymalny powiększenie
|
maxzoom | string |
Maksymalny powiększenie |
|
Kolor tła
|
bgcolor | string |
Kolor tła mapy |
|
Zmodyfikowano o
|
modified | integer |
Data ostatniej modyfikacji mapy (sygnatura czasowa systemu UNIX) |
|
Dostęp do:
|
accessed | integer |
Dostęp do mapy czasu ostatniego (sygnatura czasowa systemu UNIX) |
|
Utworzono pod adresem
|
created | integer |
Godzina utworzenia mapy (sygnatura czasowa systemu UNIX) |
|
Liczba wyświetleń
|
visited | string |
Liczba widoków mapy |
|
Archiwizowane
|
archived | string |
Jest zarchiwizowana mapa |
|
Identyfikator zasobu
|
resource_id | string |
resource_id |
|
Jednostka miary
|
measure_unit | string |
measure_unit |
|
Widoczny
|
visible | string |
widoczny |
|
Obiekt zasobu
|
resource | Resource |
Mapowanie obiektu zasobu |
|
Description
|
description | string |
Opis mapy |
|
mobileacess
|
mobileacess | string |
mobileacess |
|
wmsaccess
|
wmsaccess | string |
wmsaccess |
|
maptype
|
maptype | string |
maptype |
|
assets
|
assets | string |
assets |
|
klasyfikacja
|
rating | string |
klasyfikacja |
|
udostępnić
|
share | string |
udostępnić |
|
Granice xMin
|
bounds.xmin | float |
xmin |
|
Granice xMax
|
bounds.xmax | float |
xmax |
|
Granice yMin
|
bounds.ymin | float |
ymin |
|
Granice yMax
|
bounds.ymax | float |
ymax |
|
granica
|
bound | string |
granica |
Resource
Mapowanie obiektu zasobu
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator zasobu
|
id | integer |
Wewnętrzny identyfikator tego zasobu |
|
Typ zasobu
|
type | string |
Wyliczony typ zasobu |
|
Lokalizacja zasobu
|
location | string |
TBC z potencjalnie zerowymi wartościami |
|
Identyfikator zasobu
|
target_resource_id | string |
resource_id |
|
Identyfikator właściciela zasobu
|
owner_id | string |
Identyfikator użytkownika, który jest właścicielem tego zasobu |
|
Identyfikator elementu nadrzędnego zasobu
|
parent_id | string |
TBC z potencjalnie zerowymi wartościami |
|
Identyfikator subskrypcji płatności zasób
|
payment_subscription_id | string |
TBC z potencjalnie zerowymi wartościami |
|
Identyfikator płatności zasób
|
payment_id | string |
TBC z potencjalnie zerowymi wartościami |
|
Identyfikator płatności zasób — obs
|
payment_id_obs | string |
TBC z potencjalnie zerowymi wartościami |
|
Zarchiwizowane zasoby
|
archived | string |
Wskazuje, czy zasób został zarchiwizowany |
|
Zasób wyłączony
|
disabled | string |
TBC z potencjalnie zerowymi wartościami |
|
Czas dostępu do zasobów
|
access_time | object |
Czas ostatniego dostępu do zasobu |
|
Zmodyfikowano o
|
modified | integer |
Czas ostatniej modyfikacji zasobu (sygnatura czasowa systemu UNIX) |
|
Utworzono pod adresem
|
created | integer |
Godzina utworzenia zasobu (sygnatura czasowa systemu UNIX) |
Warstwy
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Łączna liczba rekordów
|
total | integer |
Łączna liczba rekordów, które można pobrać |
|
Bieżąca strona
|
page | integer |
Liczba zwróconej strony |
|
Obiekty warstwy
|
data | array of Layer |
Tablica zwracanych obiektów warstwowych |
Warstwa
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator warstwy
|
id | integer |
Wewnętrzny identyfikator warstwy |
|
Nazwa warstwy
|
name | string |
Nazwa warstwy zdefiniowanej przez użytkownika |
|
Obiekt właściciela
|
owner | array of string |
Obiekt właściciela warstwy, MOŻLIWOŚĆ ROZWINIĘCIA |
|
Typ źródła warstwy
|
source.type | string |
Typ dostarczonych danych |
|
Identyfikator URI źródła warstwy
|
source.src | string |
Ciąg identyfikatora URI definiujący, gdzie dane są |
|
OnScale
|
onscale | string |
Ustawianie skalowania, na którym warstwa jest widoczna |
|
Pozaskalowaniem
|
offscale | string |
Ustawianie skali, w której warstwa jest ukryta |
|
Etykieta warstwy
|
label | string |
Nazwa atrybutu źródła danych do użycia dla etykiety liniowej |
|
x min
|
x_min | string |
Współrzędna X związana z warstwą X |
|
x Maks.
|
x_max | string |
Maksymalna współrzędna związana z warstwą X |
|
y Min
|
y_min | string |
Współrzędna związana z warstwą Y |
|
y Max
|
y_max | string |
Maksymalna współrzędna związana z warstwą Y |
|
Pole tekstowe warstwy
|
textfield | string |
Nazwa atrybutu źródła danych do użycia jako pole tekstowe |
|
Zmodyfikowano o
|
modified | integer |
Data ostatniej modyfikacji mapy (sygnatura czasowa systemu UNIX) |
|
Utworzono pod adresem
|
created | integer |
Godzina utworzenia mapy (sygnatura czasowa systemu UNIX) |
|
Style warstw
|
styles | string |
Obiekt stylu złożonej warstwy na potrzeby stylów warstw |
|
Warstwa Alfa
|
alpha | string |
Przezroczystość warstw |
|
Kodowanie źródła danych warstwy
|
encoding | string |
Kodowanie źródła danych warstwy |
|
Margines tekstu warstwy
|
margin | string |
Margines pola tekstowego |
|
Widoczność warstwy
|
visible | string |
Kontroluje widoczność warstwy, "t" lub "f" |
|
Warstwa zablokowana
|
lock | string |
Kontroluje interakcyjność warstwy, "t" lub "f" |
|
Warstwa rasterowa
|
raster | string |
Warstwa jest źródłem danych rasterowych, "t" lub "f" |
|
Możliwość eksportowania warstw
|
exportable | string |
Ustaw, czy warstwę można wyeksportować, "t" lub "f" |
|
Scalona warstwa
|
merged | string |
Warstwa jest scalona |
|
Folder nadrzędny warstwy
|
parent | string |
Identyfikator warstwy folderu nadrzędnego |
|
Etykietka narzędzia warstwy
|
tooltip | string |
Etykietka narzędzia wyświetlana na wskaźniku myszy funkcji warstwy |
|
Ukryj geometrię
|
hidegeometry | string |
Ukryj geometrię warstwy. Może być przydatne, jeśli chcemy wyświetlać tylko etykiety, "t" lub "f" |
|
Korzystanie z menu podręcznego Informacje
|
use_info_window | string |
Pokaż informacje o funkcjach warstwy w wyskakującym okienku mapy, "t" lub "f" |
|
Identyfikator źródła danych warstwy
|
datasource_id | string |
Identyfikator źródła danych warstwy |
|
Warstwa EPSG
|
epsg | string |
Kod EPSG źródła danych |
|
Otwarta warstwa
|
opened | string |
W przypadku warstwy folderów otwórz/zamknij wartość logiczną, "t" lub "f" |
|
Identyfikator zasobu warstwy
|
resource_id | string |
Identyfikator zasobu warstwy |
|
Identyfikator mapy warstwy
|
map_id | string |
Identyfikator mapy, do którego należy warstwa |
|
Typ geom warstwy
|
type | string |
Typ geometrii warstwy. Możliwe wartości to "point", "line", "polygon", "tile" i "wms". |
|
Kolejność warstw
|
order | integer |
Indeks warstwy Z |
|
Obiekt Opcje warstwy
|
options | object |
Lista opcji powiązanych z tym zasobem. Ta wartość jest wyświetlana tylko wtedy, gdy parametr expand zawiera klucz "options" |
|
Nazwa formularza
|
form.name | string |
Zdefiniowana przez użytkownika nazwa dołączonego formularza |
|
Definicja formularza warstwy
|
form.definition | string |
Definicja formularza dołączonego do warstwy |
|
Identyfikator zasobu źródła danych
|
datasource.resource_id | string |
Identyfikator zasobu źródła danych |
|
Typ źródła danych
|
datasource.type | string |
Typ źródła danych dla warstwy |
|
Identyfikator właściciela źródła danych
|
datasource.owner_id | string |
owner_id |
|
uprawnienia
|
datasource.permissions | array of string |
nazwa |
|
Schemat kolumn warstwy
|
columns | object |
Pokaż kolumny źródła danych warstwy, MOŻLIWOŚĆ ROZWINIĘCIA |
|
Podwarstwy
|
sublayers | array of Layer |
Tablica obiektów warstwy zagnieżdżonych w tej warstwie |
User
| Nazwa | Ścieżka | Typ | Opis |
|---|---|---|---|
|
Identyfikator użytkownika
|
id | integer |
Unikatowy identyfikator użytkownika |
|
Typ użytkownika
|
type | string |
Określony typ użytkownika |
|
Użytkownik aktywny
|
active | string |
Czy użytkownik jest aktywny, "t" lub "f" |
|
Nazwa użytkownika
|
username | string |
Nazwa użytkownika użytkowników |
|
Imię użytkownika
|
firstname | string |
Imię użytkowników |
|
Nazwisko użytkownika
|
lastname | string |
Nazwisko użytkowników |
|
Identyfikator właściciela użytkownika
|
owner_id | string |
Identyfikator użytkownika, który jest właścicielem tego użytkownika |
|
Telefon użytkownika
|
phone | string |
Numer telefonu użytkowników |
|
User Mobile
|
mobile | string |
Numer telefonu komórkowego użytkowników |
|
Utworzono pod adresem
|
created | integer |
Godzina utworzenia mapy (sygnatura czasowa systemu UNIX) |
|
Ostatnie logowanie
|
lastlog | integer |
Godzina utworzenia mapy (sygnatura czasowa systemu UNIX) |
|
Firma użytkownika
|
company | string |
Nazwa firmy użytkowników |
|
Adres URL sieci Web użytkownika
|
web | string |
Witryna internetowa profilu użytkownika |
|
Adres e-mail użytkownika
|
string |
Adres e-mail użytkowników |
|
|
Awatar użytkownika
|
avatar | string |
Adres URL pobierania awatara użytkowników |
|
Język użytkownika
|
language | string |
Wybrany język dla użytkowników |
|
Liczba funkcji pliku
|
file_feature_count | string |
Liczba funkcji geograficznych w systemie plików |
|
Liczba funkcji bazy danych
|
db_feature_count | string |
Liczba funkcji geograficznych w bazie danych |
|
Przechowywany raster użytkownika
|
storage_raster | string |
Magazyn plików używany przez kafelki rastrowe |
|
Wydajność magazynu użytkowników
|
storage_total | string |
Łączna liczba wykorzystanych magazynów plików |
|
Limit funkcji użytkownika
|
feature_count_limit | string |
Maksymalna liczba funkcji licencji |
|
Limit rasterów użytkowników
|
storage_raster_limit | string |
Maksymalna pojemność magazynu licencjonowanego |
|
Rozpoczyna się subskrypcja
|
subscription_begins | string |
Po rozpoczęciu subskrypcji użytkowników |
|
Subskrypcja wygasa
|
subscription_expires | string |
Po zakończeniu subskrypcji użytkowników |
|
Identyfikator zasobu użytkownika
|
resource_id | string |
Wewnętrzny identyfikator zasobu dla tego użytkownika |
|
Użytkownik ostatnio zmodyfikowany
|
modified | integer |
Data ostatniej modyfikacji (format SYSTEMU UNIX) |
|
Organizacja użytkowników
|
organization_id | string |
Identyfikator organizacji dla tego użytkownika |
|
OIDC użytkownika
|
oidc | string |
OpenID Connect |
|
Opcje użytkownika
|
options | string |
Lista opcji powiązanych z użytkownikiem. Ta wartość jest wyświetlana tylko wtedy, gdy parametr "rozwiń" zawiera klucz "options" |
|
Zgody
|
consents | array of object |
Obiekt umów dotyczących zgody użytkownika |
|
Cel zgody
|
consents.purpose | string |
Cel żądanej zgody |
|
Wersja zgody
|
consents.version | string |
Wersja udzielonej zgody |
|
Zgoda uzgodniona
|
consents.agreed | string |
Czy udzielono zgody |
plik
Jest to podstawowy typ danych "file".