Spatial

Operations

Get Buffer

Dotyczy: warstwa cenowa S1.

Ten interfejs API zwraca element Featurecollection, gdzie każda funkcja jest buforem wokół odpowiedniej funkcji indeksowanej danych wejściowych. Bufor może znajdować się na zewnątrz lub wewnątrz podanej funkcji, w zależności od odległości podanej w danych wejściowych. W danych wejściowych funkcji Featurecollection musi być podana jedna odległość lub jeśli podano tylko jedną odległość, ta odległość jest stosowana do każdej funkcji w kolekcji. Bufor dodatni (lub ujemny) geometrii jest definiowany jako Minkowski sum (lub różnica) geometrii z okręgiem promienia równym wartości bezwzględnej odległości buforu. Interfejs API buforu zawsze zwraca wielokąta. Bufor liniowy i punkty o wartości ujemnej lub równej zero jest zawsze pustym wielokątem. Funkcje wejściowe są udostępniane przez plik GEOJSON, który jest przekazywany za pośrednictwem interfejsu API przekazywania danych i przywoływany przez unikatowy UDID. Plik GEOJSON może zawierać kolekcję punktów, MultiPoint, Wielokąt, MultiPolygon, LineString i MultiLineString. Obiekt GeometryCollection zostanie zignorowany, jeśli zostanie podany.

Aby przetestować ten interfejs API, można przekazać przykładowe dane z przykładowych interfejsów API do bufora (treść żądania bez tablicy odległości) za pośrednictwem interfejsu API przekazywania danych i zastąpić [UDID] z przykładowego żądania poniżej z UDID zwróconym przez interfejs API przekazywania danych.

Get Closest Point

Dotyczy: warstwa cenowa S1.

Ten interfejs API zwraca najbliższy punkt między punktem bazowym i danym zbiorem punktów w zestawie danych przekazanym przez użytkownika identyfikowanym przez UDID. Zestaw punktów docelowych jest dostarczany przez plik GEOJSON, który jest przekazywany za pośrednictwem interfejsu API przekazywania danych i przywoływany przez unikatowy UDID. Plik GEOJSON może zawierać tylko kolekcję geometryczną punktu. Program MultiPoint lub inny geometrie zostanie zignorowany, jeśli zostanie podany. Maksymalna liczba akceptowanych punktów to 100 000. Algorytm nie uwzględnia routingu ani ruchu sieciowego. Zwrócone informacje obejmują najbliższą szerokość geograficzną, długość geograficzną i odległość w licznikach od najbliższego punktu.

Aby przetestować ten interfejs API, można przekazać przykładowe dane z przykładowych interfejsów API do najbliższego punktu (treści żądania) za pośrednictwem interfejsu API przekazywania danych i zastąpić [UDID] z przykładowego żądania poniżej z UDID zwróconym przez interfejs API przekazywania danych.

Get Geofence

Interfejs API pobierania geoogrodzenia wyszukiwania

Dotyczy: Warstwa cenowa S1.

Interfejs API Get geofencingu pozwala na pobranie bliskości współrzędnej do geoogrodzenia, która została przekazana do usługi danych. Za pomocą interfejsu API przekazywania danych można przekazać geoogrodzenie lub zestaw ogrodzeniów. Aby uzyskać więcej szczegółowych informacji o formacie geograficznym, zobacz geodane GEOJSON . Aby zbadać bliskość współrzędnej, należy podać lokalizację śledzonego obiektu, a także identyfikator ogrodzenia lub zestawu ogrodzenia, a odpowiedź będzie zawierać informacje o odległości od zewnętrznej krawędzi geoogrodzenia. Wartość ujemna oznacza, że Współrzędna znajduje się wewnątrz ogrodzenia, a dodatnia wartość to poza ogrodzeniem.

Ten interfejs API może służyć do różnych scenariuszy, takich jak śledzenie zasobów, zarządzanie flotą lub Konfigurowanie alertów w celu przeniesienia obiektów.

Interfejs API obsługuje integrację z Event Grid. Parametr IsAsync służy do włączania integracji z Event Grid (domyślnie wyłączone). W celu przetestowania tego interfejsu API można przekazać przykładowe dane z przykładowych interfejsów API w postaci geoogrodzenia (treść żądania) za pośrednictwem interfejsu API przekazywania danych i zastąpić [UDID] z przykładowego żądania poniżej z UDID zwróconym przez interfejs API przekazywania danych.

InnerError — kod

W umowie dotyczącej błędu odpowiedzi geogeofencinguj innererror jest obiekt zawierający informacje o błędzie dotyczące usługi. codejest właściwością innererror , w której można mapować na konkretny typ błędu geogeofencingu. W poniższej tabeli przedstawiono mapowanie kodu między wszystkimi znanymi typ błędu klienta do odpowiadającego mu błędu geoogrodzenia message .

innererror. Code błąd. komunikat
NullDeviceId Identyfikator urządzenia nie powinien mieć wartości null.
NullUdid UDID nie może mieć wartości null.
UdidWrongFormat UDID należy uzyskać z interfejsu API pozyskiwania danych użytkownika.
InvalidUserTime Usertime jest nieprawidłowy.
InvalidSearchBuffer Searchbuffer jest nieprawidłowy.
InvalidSearchRange Zakres wartości searchbuffer powinien należeć do zakresu od 0 do 500 metrów.
InvalidLatLon Parametry "lat" i/lub "Długość =" są nieprawidłowe.
InvalidIsAsyncValue Parametr IsAsync jest nieprawidłowy.
InvalidModeValue Nieprawidłowy parametr trybu.
InvalidJson Dane geofencingu nie są prawidłowym plikiem JSON.
NotSupportedGeoJson Nie można odczytać danych geofencingu jako funkcji lub FeatureCollections.
InvalidGeoJson Dane geofencingu są nieprawidłowe.
NoUserDataWithAccountOrSubscription Nie można znaleźć danych o geoogrodzeniu użytkownika przy użyciu podanego identyfikatora konta i/lub identyfikatora subskrypcji.
NoUserDataWithUdid Nie można znaleźć danych użytkownika z podanymi udId.
Get Great Circle Distance

Dotyczy: warstwa cenowa S1.

Ten interfejs API zwróci okrąg lub najkrótszą odległość między dwoma punktami na powierzchni sfery, mierzoną wzdłuż powierzchni sfery. Różni się to od obliczania prostej linii za pośrednictwem wnętrza sfery. Ta metoda jest przydatna do oszacowania odległości podróży dla planów lotniczych przez obliczenie najkrótszej odległości między lotniskami.

Get Point In Polygon

Dotyczy: warstwa cenowa S1.

Ten interfejs API zwraca wartość logiczną wskazującą, czy punkt znajduje się wewnątrz zestawu wielokątów. Zestaw wielokątów jest dostarczany przez plik GEOJSON, który jest przekazywany za pośrednictwem interfejsu API przekazywania danych i przywoływany przez unikatowy UDID. Plik GEOJSON może zawierać Wielokąt i MultiPolygon geometrie, inne geometrie zostanie zignorowane, jeśli zostanie podany. Jeśli punkt znajduje się wewnątrz lub na granicy jednego z tych wielokątów, zwrócona wartość jest równa true. We wszystkich innych przypadkach zwrócona wartość jest równa false. Gdy punkt znajduje się wewnątrz wielu wielokątów, wynik będzie zawierać sekcję geometrie, aby wyświetlić wszystkie prawidłowe geometrie (do których odwołuje się geometryId) w danych użytkownika. Maksymalna liczba wierzchołków przyjętych do utworzenia wielokąta to 10 000.

Aby przetestować ten interfejs API, można przekazać przykładowe dane z punktu końcowego do przykładów interfejsu API wielokąta (treść żądania) za pośrednictwem interfejsu API przekazywania danych i zastąpić [UDID] z przykładowego żądania poniżej z UDID zwróconym przez interfejs API przekazywania danych.

Post Buffer

Dotyczy: warstwa cenowa S1.

Ten interfejs API zwraca element Featurecollection, gdzie każda funkcja jest buforem wokół odpowiedniej funkcji indeksowanej danych wejściowych. Bufor może znajdować się na zewnątrz lub wewnątrz podanej funkcji, w zależności od odległości podanej w danych wejściowych. W danych wejściowych funkcji Featurecollection musi być podana jedna odległość lub jeśli podano tylko jedną odległość, ta odległość jest stosowana do każdej funkcji w kolekcji. Bufor dodatni (lub ujemny) geometrii jest definiowany jako Minkowski sum (lub różnica) geometrii z okręgiem promienia równym wartości bezwzględnej odległości buforu. Interfejs API buforu zawsze zwraca wielokąta. Bufor liniowy i punkty o wartości ujemnej lub równej zero jest zawsze pustym wielokątem. Dane wejściowe mogą zawierać kolekcję punktów, MultiPoint, Wielokąt, MultiPolygon, LineString i MultiLineString. Obiekt GeometryCollection zostanie zignorowany, jeśli zostanie podany.

Post Closest Point

Dotyczy: warstwa cenowa S1.

Ten interfejs API zwraca najbliższy punkt między punktem bazowym i danym zestawem punktów docelowych. Zestaw punktów docelowych jest dostarczany przez dane użytkownika w treści żądania post. Dane użytkownika mogą zawierać tylko kolekcję geometryczną punktu. Program MultiPoint lub inny geometrie zostanie zignorowany, jeśli zostanie podany. Algorytm nie uwzględnia routingu ani ruchu sieciowego. Maksymalna liczba akceptowanych punktów to 100 000. Zwrócone informacje obejmują najbliższą szerokość geograficzną, długość geograficzną i odległość w licznikach od najbliższego punktu.

Post Geofence

Przeszukaj przeszukiwany interfejs API Dotyczy: Warstwa cenowa S1. Interfejs API wpisu geoogrodzenia pozwala na pobranie bliskości współrzędnej do podanego geoogrodzenia lub zestawu ograniczników. W przypadku wywołania POST nie ma potrzeby przekazywania danych o ograniczniku z góry, zamiast podania lokalizacji obiektu, który jest śledzony w parametrach zapytania, a także ogranicznika lub zestawu horyzontów danych w treści żądania post. Aby uzyskać więcej szczegółowych informacji o formacie geograficznym, zobacz geodane GEOJSON . Odpowiedź będzie zawierać informacje o odległości od zewnętrznej krawędzi geoogrodzenia. Wartość ujemna oznacza, że Współrzędna znajduje się wewnątrz ogrodzenia, a dodatnia wartość to poza ogrodzeniem.

Ten interfejs API może służyć do różnych scenariuszy, takich jak śledzenie zasobów, zarządzanie flotą lub Konfigurowanie alertów w celu przeniesienia obiektów.

Interfejs API obsługuje integrację z Event Grid. Parametr IsAsync służy do włączania integracji z Event Grid (domyślnie wyłączone).

Post Point In Polygon

Dotyczy: warstwa cenowa S1.

Ten interfejs API zwraca wartość logiczną wskazującą, czy punkt znajduje się wewnątrz zestawu wielokątów. Dane użytkownika mogą zawierać wielokąty i MultiPolygon geometrie, inne geometrie zostaną zignorowane, jeśli zostanie podany. Jeśli punkt znajduje się wewnątrz lub na granicy jednego z tych wielokątów, zwrócona wartość jest równa true. We wszystkich innych przypadkach zwrócona wartość jest równa false. Gdy punkt znajduje się wewnątrz wielu wielokątów, wynik będzie zawierać sekcję geometrie, aby wyświetlić wszystkie prawidłowe geometrie (do których odwołuje się geometryId) w danych użytkownika. Maksymalna liczba wierzchołków przyjętych do utworzenia wielokąta to 10 000.