Spatial

Van toepassing op: S1-prijscategorie.

Deze API retourneert een FeatureCollection waarbij elke functie een buffer is rond de bijbehorende geïndexeerde functie van de invoer. De buffer kan zich aan de buiten- of binnenzijde van de opgegeven functie bevinden, afhankelijk van de afstand die is opgegeven in de invoer. Er moet één afstand worden opgegeven per functie in de FeatureCollection-invoer, of als er slechts één afstand is opgegeven, wordt die afstand toegepast op elke functie in de verzameling. De positieve (of negatieve) buffer van een geometrie wordt gedefinieerd als de Minimum sum (of het verschil) van de geometrie met een cirkel van radius die gelijk is aan de absolute waarde van de bufferafstand. De buffer-API retourneert altijd een veelhoekig resultaat. De buffer met negatieve of nulafstand van lijnen en punten is altijd een lege veelhoek. De invoerfuncties worden geleverd door een GeoJSON-bestand dat wordt geüpload via Data Upload API en waarnaar wordt verwezen door een unieke udid. Het GeoJSON-bestand kan een verzameling Punt, MultiPoint, Polygon, MultiPolygon, LineString en MultiLineString bevatten. GeometryCollection wordt genegeerd, indien opgegeven.

Als u deze API wilt testen, kunt u de voorbeeldgegevens uit postbuffer-API-voorbeelden (matrix Aanvraag body zonder afstanden) uploaden via de Data Upload-API en de [udid] uit de onderstaande voorbeeldaanvraag vervangen door de udid die wordt geretourneerd door Data Upload API.

Van toepassing op: S1-prijscategorie.

Deze API retourneert het dichtstbijzijnde punt tussen een basispunt en een bepaalde set punten in de door de gebruiker geüploade gegevensset geïdentificeerd door udid. De set met doelpunten wordt geleverd door een GeoJSON-bestand dat wordt geüpload via Data Upload API en waarnaar wordt verwezen door een unieke udid. Het GeoJSON-bestand mag alleen een verzameling puntgeometrie bevatten. MultiPoint of andere geometrieën worden genegeerd indien opgegeven. Het maximum aantal geaccepteerde punten is 100.000. Het algoritme houdt geen rekening met routering of verkeer. Geretourneerde informatie omvat de dichtstbijzijnde puntbreedte, lengtegraad en afstand in meters van het dichtstbijzijnde punt.

Als u deze API wilt testen, kunt u de voorbeeldgegevens uit post dichtstbijzijnde punt-API-voorbeelden (Aanvraag body) uploaden via de Data Upload-API en de [udid] uit de onderstaande voorbeeldaanvraag vervangen door de udid die wordt geretourneerd door de Data Upload-API.

Zoeken in Geofence Get API

Van toepassing op: Prijscategorie S1.

Met de Get-API van Geofence kunt u de nabijheid van een coördinaat ophalen van een geofence die is geüpload naar de Data-service. U kunt de Data Upload API gebruiken om een geofence of set fences te uploaden. Zie Geofencing GeoJSON data (Geofencing GeoJSON-gegevens) voor meer informatie over de geofence-gegevensindeling. Als u de nabijheid van een coördinaat wilt opvragen, geeft u de locatie op van het object dat u volgt, evenals de id voor de fence of reeks fences, en bevat het antwoord informatie over de afstand van de buitenste rand van de geofence. Een negatieve waarde geeft aan dat de coördinaat zich binnen de fence en een positieve waarde betekent dat deze zich buiten de fence.

Deze API kan worden gebruikt voor verschillende scenario's, waaronder het bijhouden van activa, vlootbeheer of het instellen van waarschuwingen voor het verplaatsen van objecten.

De API ondersteunt integratie met Event Grid. De parameter isAsync wordt gebruikt om integratie met Event Grid in te stellen (standaard uitgeschakeld). Als u deze API wilt testen, kunt u de voorbeeldgegevens uit Post Geofence API examples(Request Body) via Data Upload API uploaden en de [udid] uit de onderstaande voorbeeldaanvraag vervangen door de udid die wordt geretourneerd door Data Upload API.

Geofencing InnerError-code

In geofencing response error contract innererror is een object met servicespecifieke informatie over de fout. code is een eigenschap waarin innererror kan worden toe te wijs aan een specifiek geofencing-fouttype. In de onderstaande tabel ziet u de codetoewijzing tussen het bekende clientfouttype en de bijbehorende geofencing-fout message .

Van toepassing op: S1-prijscategorie.

Deze API retourneerde de grote cirkel of kortste afstand tussen twee punten op het oppervlak van een bol, gemeten langs het oppervlak van de bol. Dit wijkt af van het berekenen van een rechte lijn door het binnenste van de bol. Deze methode is handig voor het schatten van reisafstanden voor vliegtuigen door de kortste afstand tussen luchthavens te berekenen.

Van toepassing op: S1-prijscategorie.

Deze API retourneert een Booleaanse waarde die aangeeft of een punt zich binnen een set veelhoeken. De set veelhoeken wordt geleverd door een GeoJSON-bestand dat wordt geüpload via Data Upload API en waarnaar wordt verwezen door een unieke udid. Het GeoJSON-bestand kan Polygon- en MultiPolygon-geometrieën bevatten, andere geometrieën worden genegeerd indien opgegeven. Als het punt binnen of op de grens van een van deze veelhoeken ligt, is de geretourneerde waarde true. In alle andere gevallen is de geretourneerde waarde onwaar. Wanneer het punt zich in meerdere veelhoeken, geeft het resultaat de sectie intersecting geometrieën om alle geldige geometrieën weer te geven (waarnaar wordt verwezen door geometryId) in gebruikersgegevens. Het maximum aantalticen dat wordt geaccepteerd om een veelhoek te vormen, is 10.000.

Als u deze API wilt testen, kunt u de voorbeeldgegevens van Post Point In Polygon API-voorbeelden (Aanvraag body) uploaden via de Data Upload-API en de [udid] uit de onderstaande voorbeeldaanvraag vervangen door de udid die wordt geretourneerd door de Data Upload-API.

Van toepassing op: S1-prijscategorie.

Deze API retourneert een FeatureCollection waarbij elke functie een buffer is rond de bijbehorende geïndexeerde functie van de invoer. De buffer kan zich aan de buiten- of binnenzijde van de opgegeven functie bevinden, afhankelijk van de afstand die is opgegeven in de invoer. Er moet één afstand worden opgegeven per functie in de FeatureCollection-invoer, of als er slechts één afstand is opgegeven, wordt die afstand toegepast op elke functie in de verzameling. De positieve (of negatieve) buffer van een geometrie wordt gedefinieerd als de Minimum sum (of het verschil) van de geometrie met een cirkel van radius die gelijk is aan de absolute waarde van de bufferafstand. De buffer-API retourneert altijd een veelhoekig resultaat. De buffer met negatieve of nulafstand van lijnen en punten is altijd een lege veelhoek. De invoer kan een verzameling punt, MultiPoint, Veelhoek, MultiPolygon, LineString en MultiLineString bevatten. GeometryCollection wordt genegeerd, indien opgegeven.

Van toepassing op: S1-prijscategorie.

Deze API retourneert het dichtstbijzijnde punt tussen een basispunt en een bepaalde set doelpunten. De set met doelpunten wordt geleverd door gebruikersgegevens in de post-aanvraag body. De gebruikersgegevens bevatten mogelijk alleen een verzameling puntgeometrie. MultiPoint of andere geometrieën worden genegeerd indien opgegeven. Het algoritme houdt geen rekening met routering of verkeer. Het maximum aantal geaccepteerde punten is 100.000. Geretourneerde informatie omvat de dichtstbijzijnde puntbreedte, lengtegraad en afstand in meters van het dichtstbijzijnde punt.

Zoeken in Geofence Post-API Van toepassing op: Prijscategorie S1. Met de Geofence Post-API kunt u de nabijheid van een coördinaat ophalen bij een opgegeven geofence of set fences. Met POST-aanroep hoeft u de fencegegevens niet van tevoren te uploaden. In plaats daarvan moet u de locatie opgeven van het object dat u volgt in queryparameters, evenals de fence of set fences-gegevens in de post-aanvraag body. Zie Geofencing GeoJSON data (Geofencing GeoJSON-gegevens) voor meer informatie over de geofence-gegevensindeling. Het antwoord bevat informatie over de afstand van de buitenste rand van de geofence. Een negatieve waarde geeft aan dat de coördinaat zich binnen de fence en een positieve waarde betekent dat deze zich buiten de fence.

Deze API kan worden gebruikt voor verschillende scenario's, waaronder het bijhouden van activa, vlootbeheer of het instellen van waarschuwingen voor het verplaatsen van objecten.

De API ondersteunt integratie met Event Grid. De parameter isAsync wordt gebruikt om integratie met Event Grid in te stellen (standaard uitgeschakeld).

Van toepassing op: S1-prijscategorie.

Deze API retourneert een Booleaanse waarde die aangeeft of een punt zich binnen een set veelhoeken. De gebruikersgegevens kunnen Polygon- en MultiPolygon-geometrieën bevatten, andere geometrieën worden genegeerd als deze worden opgegeven. Als het punt binnen of op de grens van een van deze veelhoeken ligt, is de geretourneerde waarde true. In alle andere gevallen is de geretourneerde waarde onwaar. Wanneer het punt zich binnen meerdere veelhoeken beidt, geeft het resultaat de sectie intersecting geometrieën om alle geldige geometrieën (waarnaar wordt verwezen door geometryId) in gebruikersgegevens weer te geven. Het maximum aantalticen dat wordt geaccepteerd om een veelhoek te vormen, is 10.000.