Spatial

Platí pro: Cenová úroveň S1.

Toto rozhraní API vrátí FeatureCollection, kde každá funkce je vyrovnávací paměť kolem odpovídající indexované funkce vstupu. Vyrovnávací paměť může být buď na vnější straně, nebo uvnitř poskytnuté funkce v závislosti na vzdálenosti zadané ve vstupu. Ve vstupu FeatureCollection musí být poskytnuta jedna vzdálenost pro každou funkci, nebo pokud je k dispozici pouze jedna vzdálenost, pak se tato vzdálenost použije na každou funkci v kolekci. Kladná (nebo záporná) vyrovnávací paměť geometrie je definována jako mink součet (nebo rozdíl) geometrie s kruhem poloměru, který se rovná absolutní hodnotě vzdálenosti vyrovnávací paměti. Rozhraní API vyrovnávací paměti vždy vrací mnohoúhelníkový výsledek. Záporná vyrovnávací paměť nebo vyrovnávací paměť s nulovou vzdáleností čar a bodů je vždy prázdný mnohoúhelník. Vstupní funkce poskytuje soubor GeoJSON, který se nahrává prostřednictvím rozhraní Data Upload API a odkazuje na ně jedinečné udid. Soubor GeoJSON může obsahovat kolekci Point, MultiPoint, Polygon, MultiPolygon, LineString a MultiLineString. GeometryCollection bude ignorováno, pokud je k dispozici.

Pokud chcete toto rozhraní API otestovat, můžete nahrát ukázková data z příkladů rozhraní API pro vyrovnávací paměť post (text požadavku bez pole vzdáleností) prostřednictvím rozhraní Data Upload API a nahradit [udid] z níže uvedené ukázkové žádosti udid vrácenou rozhraním Data Upload API.

Platí pro: Cenová úroveň S1.

Toto rozhraní API vrátí nejbližší bod mezi základním bodem a danou sadu bodů v datové sadě nahrané uživatelem identifikované uživatelem udid. Sadu cílových bodů poskytuje soubor GeoJSON, který se nahrává prostřednictvím rozhraní Data Upload API a odkazuje na ně jedinečné udid. Soubor GeoJSON může obsahovat pouze kolekci geometrie bodu. MultiPoint nebo jiné geometrie se budou ignorovat, pokud jsou k dispozici. Maximální počet přijatých bodů je 100 000. Algoritmus nezohlední směrování ani provoz. Vrácené informace zahrnují nejbližší zeměpisnou šířku bodu, zeměpisnou délku a vzdálenost v metrech od nejbližšího bodu.

Pokud chcete toto rozhraní API otestovat, můžete nahrát ukázková data z příkladů rozhraní POST Closest Point API (Text požadavku) prostřednictvím rozhraní Data Upload API a nahradit [udid] z níže uvedené ukázkové žádosti udid vrácenou rozhraním Data Upload API.

Rozhraní API pro hledání geografické geografické úrovně

Platí pro: Cenová úroveň S1.

Rozhraní Geofence Get API umožňuje načíst vzdálenost souřadnice k geografické geografické oblasti nahrané do Data. K nahrání geografické Upload sady plotů můžete použít rozhraní DATA Upload API. Další podrobnosti o formátu dat geografické ochrany najdete v tématu Geofencing GeoJSON data . Pokud chcete zadat dotaz na vzdálenost souřadnice, zadejte umístění objektu, který sledujete, a TAKÉ ID plotu nebo sady plotů a odpověď bude obsahovat informace o vzdálenosti od vnějšího okraje geografické oblasti. Záporná hodnota znamená, že souřadnice je uvnitř plotu, zatímco kladná hodnota znamená, že je mimo plot.

Toto rozhraní API je možné použít v nejrůznějších scénářích, mezi které patří sledování prostředků, správa vozového parku nebo nastavení upozornění pro přesun objektů.

Rozhraní API podporuje integraci s Event Grid. Parametr isAsync slouží k povolení integrace s Event Grid (ve výchozím nastavení zakázáno). Pokud chcete toto rozhraní API otestovat, můžete nahrát ukázková data z příkladů rozhraní Post Geofence API (Text požadavku) prostřednictvím rozhraní Api pro data Upload a nahradit [udid] z ukázkového požadavku níže udid vrácenou rozhraním Data Upload API.

Kód Geofencing InnerError

V kontraktu chyb geografické reakce je objekt obsahující informace o chybě specifické innererror pro službu. code je vlastnost, ve innererror které se může mapovat na konkrétní typ chyby geofencingu. Následující tabulka ukazuje mapování kódu mezi všemi známými typy chyb klienta a odpovídající geografickou chybou message .

Platí pro: Cenová úroveň S1.

Toto rozhraní API vrátí velký kruh nebo nejkratší vzdálenost mezi dvěma body na povrchu kouli, měřená podél povrchu kouli. To se liší od výpočtu přímky přes vnitřní kouli. Tato metoda je užitečná pro odhad cestovní vzdálenosti letadel výpočtem nejkratší vzdálenosti mezi letištěmi.

Platí pro: Cenová úroveň S1.

Toto rozhraní API vrátí logickou hodnotu určující, jestli je bod uvnitř sady mnohoúhelníků. Sadu mnohoúhelníků poskytuje soubor GeoJSON, který se nahrává prostřednictvím rozhraní Data Upload API a odkazuje na ně jedinečné udid. Soubor GeoJSON může obsahovat mnohoúhelníkové geometrie a geometrie MultiPolygonu, ostatní geometrie budou ignorovány, pokud jsou k dispozici. Pokud je bod uvnitř nebo na hranici jednoho z těchto mnohoúhelníků, vrácená hodnota je true. Ve všech ostatních případech je vrácená hodnota false. Když je bod uvnitř více mnohoúhelníků, výsledek poskytne průnik geometrie, aby se v uživatelských datech ukázaly všechny platné geometrie (odkazované pomocí geometryId). Maximální počet vrcholů přijatých k vytvoření mnohoúhelníku je 10 000.

Pokud chcete toto rozhraní API otestovat, můžete nahrát ukázková data z příkladů rozhraní POST Point In Polygon API (Text požadavku) prostřednictvím rozhraní Data Upload API a nahradit [udid] z následujícího ukázkového požadavku udid vrácenou rozhraním Data Upload API.

Platí pro: Cenová úroveň S1.

Toto rozhraní API vrátí FeatureCollection, kde každá funkce je vyrovnávací paměť kolem odpovídající indexované funkce vstupu. Vyrovnávací paměť může být buď na vnější straně, nebo uvnitř poskytnuté funkce v závislosti na vzdálenosti zadané ve vstupu. Ve vstupu FeatureCollection musí být poskytnuta jedna vzdálenost pro každou funkci, nebo pokud je k dispozici pouze jedna vzdálenost, pak se tato vzdálenost použije na každou funkci v kolekci. Kladná (nebo záporná) vyrovnávací paměť geometrie je definována jako mink součet (nebo rozdíl) geometrie s kruhem poloměru, který se rovná absolutní hodnotě vzdálenosti vyrovnávací paměti. Rozhraní API vyrovnávací paměti vždy vrací mnohoúhelníkový výsledek. Záporná vyrovnávací paměť nebo vyrovnávací paměť s nulovou vzdáleností čar a bodů je vždy prázdný mnohoúhelník. Vstup může obsahovat kolekci Point, MultiPoint, Polygon, MultiPolygon, LineString a MultiLineString. GeometryCollection bude ignorováno, pokud je k dispozici.

Platí pro: Cenová úroveň S1.

Toto rozhraní API vrátí nejbližší bod mezi základním bodem a danou sadu cílových bodů. Sadu cílových bodů poskytují uživatelská data v textu po požadavku. Uživatelská data mohou obsahovat pouze kolekci geometrie bodu. MultiPoint nebo jiné geometrie se budou ignorovat, pokud jsou k dispozici. Algoritmus nezohlední směrování ani provoz. Maximální počet přijatých bodů je 100 000. Vrácené informace zahrnují nejbližší zeměpisnou šířku bodu, zeměpisnou délku a vzdálenost v metrech od nejbližšího bodu.

Rozhraní API Prohledat geografickou replikaci po Platí pro: Cenová úroveň S1. Rozhraní API Geofence Post umožňuje načíst vzdálenost souřadnice k zadané geografické oblasti nebo sadě plotů. Při volání POST není možné nahrávat data plotu předem, místo toho do parametrů dotazu zadávat umístění objektu, který sledujete, a také plot nebo sadu dat ohrazení v textu požadavku. Další podrobnosti o datovém formátu geografického ohraničení najdete v tématu geografická data geografické služby. Odpověď bude obsahovat informace o vzdálenosti od vnějšího okraje geograficky. Záporná hodnota znamená, že souřadnice jsou uvnitř plotu, zatímco kladná hodnota znamená, že je mimo plot.

Toto rozhraní API se dá použít pro celou řadu scénářů, které zahrnují věci jako sledování prostředků, řízení loďstva nebo nastavení výstrah pro přesun objektů.

Rozhraní API podporuje integraci s Event Grid. Parametr-Async se používá k povolení integrace s Event Grid (ve výchozím nastavení zakázaná).

Platí pro: cenová úroveň S1.

Toto rozhraní API vrací logickou hodnotu, která označuje, zda je bod uvnitř sady mnohoúhelníků. Uživatelská data mohou obsahovat mnohoúhelník a geometriíy s více geometrií, pokud jsou k dispozici, budou ignorovány. Pokud je bod uvnitř nebo na hranici jednoho z těchto mnohoúhelníků, vrácená hodnota je true. Ve všech ostatních případech je vrácená hodnota false. V případě, že je bod uvnitř více mnohoúhelníků, výsledek poskytne geometrií část s proprotínající všechny platné geometrií (na kterou odkazuje geometryId) v uživatelských datech. Maximální počet vrcholů přijatých k vytvoření mnohoúhelníku je 10 000.