Skapare för inomhuskartor

Den här artikeln introducerar begrepp och verktyg som gäller för Azure Kartor Creator. Vi rekommenderar att du läser den här artikeln innan du börjar använda Azure Kartor Creator API och SDK.

Du kan använda Creator för att utveckla program med kartfunktioner som baseras på inomhuskartdata. I den här artikeln beskrivs processen för att ladda upp, konvertera, skapa och använda dina kartdata. Arbetsflödet utförs vanligtvis av två olika personer med olika expertkunskaper och ansvarsområden:

• Kartskapare: ansvarar för att curating and preparing the map data (Kartdata).
• Skapare av kartdataanvändare: använder kundkartadata i program.

Följande diagram illustrerar hela arbetsflödet.

Skapa Azure Kartor Creator

Om du vill använda Creator-tjänster måste Azure Kartor Creator skapas i ett Azure Kartor-konto med prisnivån Gen 2. Information om hur du skapar Azure Kartor Creator i Azure Kartor finns i Hantera Azure Kartor Creator.

Autentisering med skapare

Skaparen ärver Azure Kartor Access Control(IAM)-inställningar. Alla API-anrop för dataåtkomst måste skickas med autentiserings- och auktoriseringsregler.

Creator-användningsdata ingår i azure-Kartor användningsdiagram och aktivitetsloggar. Mer information finns i Hantera autentisering i Azure Kartor.

Dataobjekttyper för skapare

Creator-tjänster skapare skapar, lagrar och använder olika datatyper som definieras och diskuteras i följande avsnitt. Ett dataobjekt för skapare kan vara av följande typer:

• Konverterade data
• Datamängd
• Paneluppsättning
• Funktions tillståndsuppsättning

Upload ett ritningspaket

Skaparen samlar in kartdata för inomhus genom att konvertera ett uppladdat ritningspaket. Ritningspaketet representerar en konstruerad eller ombyggd anläggning. Information om kraven för ritningspaket finns i Krav för ritningspaket.

Använd Azure Kartor Data Upload API för att ladda upp ett ritningspaket. När ritningspackningen har laddats upp returnerar DATA Upload-API:et en identifierare för användardata ( udid ). kan udid sedan användas för att konvertera det uppladdade paketet till inomhuskartdata.

Konvertera ett ritningspaket

Tjänsten Azure Kartor Conversion konverterar ett uppladdat ritningspaket till inomhuskartdata. Konverteringstjänsten validerar även paketet. Verifieringsproblem klassificeras i två typer:

• Fel: Om några fel upptäcks misslyckas konverteringsprocessen. När ett fel inträffar tillhandahåller konverteringstjänsten en länk till den fristående webbappen Azure Kartor Drawing Error Visualizer. Du kan använda Visualisering av ritningsfel för att granska varningar och fel som uppstod under konverteringsprocessen. När du har åtgärdat felen kan du försöka ladda upp och konvertera paketet.
• Varningar: Om några varningar identifieras lyckas konverteringen. Vi rekommenderar dock att du granskar och löser alla varningar. En varning innebär att en del av konverteringen ignorerades eller åtgärdades automatiskt. Om du inte löser varningarna kan det leda till fel i senare processer. Mer information finns i Ritning av paketvarningar och fel.

Skapa inomhuskartdata

Azure Kartor Creator tillhandahåller följande tjänster som stöder kartskapande:

• Datamängdstjänst.
• Tileset-tjänsten. Använd tjänsten Tileset för att skapa en vektorbaserad representation av en datauppsättning. Program kan använda en paneluppsättning för att presentera en visuell panelbaserad vy av datauppsättningen.
• Funktionstillståndstjänst. Använd tjänsten Funktionstillstånd för att stödja dynamisk kartstil. Program kan använda dynamisk kartstil för att återspegla realtidshändelser i utrymmen som tillhandahålls av IoT-systemet.

Datauppsättningar

En datamängd är en samling inomhuskartfunktioner. Funktionerna för inomhuskart representerar anläggningar som definieras i ett konverterat ritningspaket. När du har skapat en datauppsättning med datauppsättningstjänstenkan du skapa val av paneluppsättningar eller funktions tillståndsuppsättningar.

Utvecklare kan när som helst använda datauppsättningstjänsten för att lägga till eller ta bort anläggningar i en befintlig datauppsättning. Mer information om hur du uppdaterar en befintlig datauppsättning med hjälp av API:et finns i tilläggsalternativen i datauppsättningstjänsten. Ett exempel på hur du uppdaterar en datauppsättning finns i Dataunderhåll.

Tilesets

En paneluppsättning är en samling vektordata som representerar en uppsättning enhetliga rutnätspaneler. Utvecklare kan använda tjänsten Tileset för att skapa paneluppsättningar från en datauppsättning.

Om du vill återspegla olika innehållsfaser kan du skapa flera paneluppsättningar från samma datauppsättning. Du kan till exempel göra en paneluppsättning med apparater och utrustning och en annan paneluppsättning utan golv och utrustning. Du kan välja att generera en paneluppsättning med de senaste datauppdateringarna och en annan paneluppsättning utan de senaste datauppdateringarna.

Förutom vektordata tillhandahåller paneluppsättningen metadata för optimering av kartrendering. Till exempel innehåller tileset-metadata en lägsta och högsta zoomningsnivå för paneluppsättningen. Metadata innehåller också en begränsningsruta som definierar paneluppsättningens geografiska omfattning. Ett program kan använda en begränsningsruta för att programmatiskt ange rätt mittpunkt. Mer information om metadata för tileset finns i Tileset List API.

När en paneluppsättning har skapats kan den hämtas av Render V2-tjänsten.

Om en paneluppsättning blir inaktuell och inte längre är användbar kan du ta bort paneluppsättningen. Information om hur du tar bort paneluppsättningar finns i Dataunderhåll.

Funktions tillståndsuppsättningar

Funktions tillståndsuppsättningar är samlingar av dynamiska egenskaper (tillstånd) som tilldelas datamängdsfunktioner, till exempel rum eller utrustning. Ett exempel på ett tillstånd kan vara temperatur eller användning. Varje tillstånd är ett nyckel/värde-par som innehåller namnet på egenskapen, värdet och tidsstämpeln för den senaste uppdateringen.

Du kan använda tjänsten Funktionstillstånd för att skapa och hantera en funktionstillståndsuppsättning för en datauppsättning. Tillståndsuppsättningen definieras av ett eller flera tillstånd. Varje funktion, till exempel ett rum, kan ha ett kopplat tillstånd.

Värdet för varje tillstånd i en tillståndsuppsättning kan uppdateras eller hämtas av IoT-enheter eller andra program. Om du till exempel använder API:etfunktionstillståndsuppdatering kan enheter som mäter utrymmesbeläggning systematiskt publicera tillståndsändringen för ett rum.

Ett program kan använda en funktionstillståndsuppsättning för att dynamiskt återge funktioner i en anläggning enligt deras aktuella tillstånd och respektive kartformat. Mer information om hur du använder funktions tillståndsuppsättningar för att formatera funktioner i en renderingskarta finns i Kartor modulen.

Använda inomhuskartor

API för V2-Get mappningspanel

API:et Kartor Render V2-Get Map Tile har utökats för att stödja Creator-paneler.

Program kan använda API:et Render V2-Get Map Tile för att begära paneluppsättningar. Paneluppsättningarna kan sedan integreras i en kartkontroll eller SDK. Ett exempel på en kartkontroll som använder rendera V2-tjänsten finns i Kartor inomhusmodul.

WEBBFUNKTIONSTJÄNST API

Du kan använda api:et Webbfunktionstjänst (WFS) för att köra frågor mot datauppsättningar. WFS följer Open Geospatial Consortium API-funktioner. Du kan använda WFS-API:et för att fråga efter funktioner i själva datauppsättningen. Du kan till exempel använda WFS för att hitta alla mellanstora mötesrum på en specifik anläggning och golvnivå.

Alias-API

Creator-tjänster som Konvertering, Datauppsättning, Paneler och Funktionstillstånd returnerar en identifierare för varje resurs som skapas från API:erna. Med alias-API:et kan du tilldela ett alias för att referera till en resursidentifierare.

Modul för inomhuskartor

Azure Kartor Web SDK innehåller modulen Kartor inomhus. Den här modulen innehåller utökade funktioner för Azure Kartor Kartkontroll biblioteket. Modulen Kartor renderar inomhuskartor som skapats i Creator. Den integrerar widgetar, till exempel golvväljare, som hjälper användarna att visualisera de olika golven.

Du kan använda modulen Kartor för att skapa webbprogram som integrerar inomhuskartdata med andra Azure Kartor tjänster. De vanligaste programkonfigurationerna är att lägga till kunskap från andra kartor – till exempel väg, bilder, väder och transport – till inomhuskartor.

Modulen Kartor stöder även dynamisk kartstil. En stegvis genomgång för att implementera funktions tillståndsuppsättningen dynamisk stil i ett program finns i Använda modulen Inomhuskarta.

Azure Kartor-integrering

När du börjar utveckla lösningar för inomhuskartor kan du hitta sätt att integrera befintliga Azure Kartor funktioner. Du kan till exempel implementera scenarier för tillgångsspårning eller säkerhet med hjälp av Azure Kartor Geofence-API:et med inomhuskartor för Creator. Du kan till exempel använda Geofence-API:et för att avgöra om en arbetare kommer in i eller lämnar specifika inomhusområden. Mer information om hur du ansluter Azure Kartor med IoT-telemetri finns i den här självstudien om rumslig IoT-analys.

Dataunderhåll

Du kan använda AZURE Kartor Creator List, Update och Delete API för att lista, uppdatera och ta bort dina datauppsättningar, paneler och funktions tillståndsuppsättningar.

Exempel: Uppdatera en datauppsättning

I följande exempel visas hur du uppdaterar en datauppsättning, skapar en ny paneluppsättning och tar bort en gammal paneluppsättning:

1. Följ stegen i avsnitten Upload ett ritningspaket och Konvertera ett ritningspaket för att ladda upp och konvertera det nya ritningspaketet.
2. Använd API:et För att skapa datamängd för att lägga till konverterade data i den befintliga datauppsättningen.
3. Använd API:et För att skapa tileset för att generera en ny paneluppsättning från den uppdaterade datauppsättningen.
4. Spara det nya tilesetId för nästa steg.
5. Om du vill aktivera visualiseringen av den uppdaterade campusdatamängden uppdaterar du paneluppsättningsidentifieraren i ditt program. Om den gamla paneluppsättningen inte längre används kan du ta bort den.

Nästa steg