Maker voor plattegronden
In dit artikel worden concepten en hulpprogramma's beschreven die van toepassing zijn op Azure Kaarten Creator. U wordt aangeraden dit artikel te lezen voordat u begint met het gebruik van de Azure Kaarten Creator API en SDK.
U kunt Creator gebruiken om toepassingen te ontwikkelen met kaartfuncties die zijn gebaseerd op indoorkaartgegevens. In dit artikel wordt het proces beschreven van het uploaden, converteren, maken en gebruiken van uw kaartgegevens. Normaal gesproken wordt de werkstroom voltooid door twee verschillende persona's met verschillende expertise- en verantwoordelijkheidsgebieden:
- Kaartmaker: verantwoordelijk voor het cureren en voorbereiden van de kaartgegevens.
- Maker kaartgegevensgebruiker: maakt gebruik van klantkaartgegevens in toepassingen.
Het volgende diagram illustreert de hele werkstroom.
Azure Kaarten Creator maken
Als u Creator-services wilt gebruiken, moet Azure Kaarten Creator worden gemaakt in een Azure Kaarten-account met de prijscategorie Gen 2. Zie Manage Azure Kaarten Creator (Azure Kaarten Creator beheren) voor meer informatie over het maken van Azure Kaarten Creator in Azure Kaarten.
Tip
Zie de sectie Creator in Azure Kaarten pricing voor prijsinformatie.
Creator-verificatie
Creator neemt azure Kaarten Access Control -instellingen (IAM) over. Alle API-aanroepen voor gegevenstoegang moeten worden verzonden met verificatie- en autorisatieregels.
Gebruiksgegevens van creator worden opgenomen in uw Azure Kaarten grafieken met gebruiksgegevens en activiteitenlogboek. Zie Verificatie beheren in Azure Kaarten voor meer Kaarten.
Belangrijk
We raden u aan het volgende te gebruiken:
Azure Active Directory (Azure AD) in alle oplossingen die zijn gebouwd met een Azure Kaarten-account met behulp van Creator-services. Zie Azure AD-verificatie voor meer informatie over Azure AD.
Instellingen voor op rollen gebaseerd toegangsbeheer. Met behulp van deze instellingen kunnen kaartmakers fungeren als de rol van Azure Kaarten Data Contributor en kunnen gebruikers van creator-kaartgegevens fungeren als de rol van Azure Kaarten Data Reader. Zie Autorisatie met op rollen gebaseerd toegangsbeheer voor meer informatie.
Gegevensitemtypen voor creator
Creator-services maken, opslaan en gebruiken verschillende gegevenstypen die in de volgende secties worden gedefinieerd en besproken. Een creator-gegevensitem kan van de volgende typen zijn:
- Geconverteerde gegevens
- Gegevensset
- Tegelset
- Functie-stateset
Een tekenpakket uploaden
Creator verzamelt indoor kaartgegevens door een geüpload tekenpakket te converteren. Het tekenpakket vertegenwoordigt een samengestelde of opnieuw gemodelleerde faciliteit. Zie Tekenpakketvereisten voor meer informatie over vereisten voor tekenpakketten.
Gebruik de Azure Kaarten Data Upload-API om een tekenpakket te uploaden. Nadat de verpakking van de tekening is geüpload, retourneert de Data Upload-API een gebruikersgegevens-id ( udid ). De udid kan vervolgens worden gebruikt om het geüploade pakket te converteren naar indoorkaartgegevens.
Een tekenpakket converteren
De Azure Kaarten Conversion-service converteert een geüpload tekenpakket naar plattegrondgegevens. De Conversieservice valideert ook het pakket. Validatieproblemen worden geclassificeerd in twee typen:
- Fouten: als er fouten worden gedetecteerd, mislukt het conversieproces. Wanneer er een fout optreedt, biedt de Conversieservice een koppeling naar de azure Kaarten de standaardwebtoepassing Voor het visualiseren van tekenfouten. U kunt de Visualizer voor tekenfouten gebruiken om waarschuwingen en fouten van tekenpakketten te inspecteren die tijdens het conversieproces zijn opgetreden. Nadat u de fouten hebt opgelost, kunt u proberen het pakket te uploaden en te converteren.
- Waarschuwingen: als er waarschuwingen worden gedetecteerd, slaagt de conversie. We raden u echter aan alle waarschuwingen te controleren en op te lossen. Een waarschuwing betekent dat een deel van de conversie is genegeerd of automatisch is opgelost. Als de waarschuwingen niet worden opgelost, kunnen er fouten optreden in latere processen. Zie Waarschuwingen en fouten voor tekenpakketten voor meer informatie.
Indoorkaartgegevens maken
Azure Kaarten Creator biedt de volgende services die het maken van kaarten ondersteunen:
- Gegevenssetservice.
- Tegelsetservice. Gebruik de Tegelset-service om een op vector gebaseerde weergave van een gegevensset te maken. Toepassingen kunnen een tegelset gebruiken om een weergave op basis van een visuele tegel van de gegevensset te presenteren.
- Functiestatusservice. Gebruik de functie Statusservice om dynamische kaartstijlen te ondersteunen. Toepassingen kunnen dynamische kaartstijlen gebruiken om realtime gebeurtenissen weer te geven in ruimten die worden geleverd door het IoT-systeem.
Gegevenssets
Een gegevensset is een verzameling functies voor plattegronden. De plattegrondfuncties vertegenwoordigen faciliteiten die zijn gedefinieerd in een geconverteerd tekenpakket. Nadat u een gegevensset hebt gemaakt met de gegevenssetservice, kunt u een groot aantal tegelsets of functie-statesets maken.
Ontwikkelaars kunnen op elk moment de gegevenssetservice gebruiken om faciliteiten toe te voegen aan of te verwijderen uit een bestaande gegevensset. Zie de opties voor het appen van gegevenssets in De gegevenssetservice voor meer informatie over het bijwerken van een bestaande gegevensset met behulp van de API. Zie Gegevensonderhoud voor een voorbeeld van het bijwerken van een gegevensset.
Tegelsets
Een tegelset is een verzameling vectorgegevens die een set uniforme rastertegels vertegenwoordigt. Ontwikkelaars kunnen de Tegelset-service gebruiken om tegelsets te maken op basis van een gegevensset.
Als u verschillende inhoudsfasen wilt weerspiegelen, kunt u meerdere tegelsets maken op basis van dezelfde gegevensset. U kunt bijvoorbeeld één tegelset maken met gereedschap en apparatuur en een andere tegelset zonder gereedschap en apparatuur. U kunt ervoor kiezen om één tegelset te genereren met de meest recente gegevensupdates en een andere tegelset zonder de meest recente gegevensupdates.
Naast de vectorgegevens biedt de tegelset metagegevens voor optimalisatie van kaartweergaven. Metagegevens van tegelset bevatten bijvoorbeeld een minimum- en maximum zoomniveau voor de tegelset. De metagegevens bieden ook een begrensingsvak dat het geografische gebied van de tegelset definieert. Een toepassing kan een begrensingsvak gebruiken om programmatisch het juiste middenpunt in te stellen. Zie Tegelsetlijst-API voor meer informatie over tegelsetmetagegevens.
Nadat een tegelset is gemaakt, kan deze worden opgehaald door de Render V2-service.
Als een tegelset verouderd raakt en niet meer nuttig is, kunt u de tegelset verwijderen. Zie Gegevensonderhoud voor meer informatie over het verwijderen van tegelsets.
Notitie
Een tegelset is onafhankelijk van de gegevensset van waaruit deze is gemaakt. Als u tegelsets maakt op basis van een gegevensset en vervolgens die gegevensset bij werkt, worden de tegelsets niet bijgewerkt.
Als u wijzigingen in een gegevensset wilt weerspiegelen, moet u nieuwe tegelsets maken. Op dezelfde manier wordt de gegevensset niet beïnvloed als u een tegelset verwijdert.
Functie-statesets
Functie-statesets zijn verzamelingen dynamische eigenschappen (staten) die worden toegewezen aan gegevenssetfuncties, zoals ruimten of apparatuur. Een voorbeeld van een status kan temperatuur of bezetting zijn. Elke status is een sleutel-waardepaar dat de naam van de eigenschap, de waarde en de tijdstempel van de laatste update bevat.
U kunt de functie state-service gebruiken voor het maken en beheren van een functie statusset voor een gegevensset. De stateset wordt gedefinieerd door een of meer staten. Aan elke functie, zoals een ruimte, kan één status zijn gekoppeld.
De waarde van elke status in een statusset kan worden bijgewerkt of opgehaald door IoT-apparaten of andere toepassingen. Met behulp van de Api voor functietoestandupdateskunnen apparaten die de ruimtebezetting meten bijvoorbeeld systematisch de statuswijziging van een ruimte posten.
Een toepassing kan een functietoestandset gebruiken om functies in een faciliteit dynamisch weer te geven op basis van hun huidige status en respectieve kaartstijl. Zie De module Indoor Kaarten voor meer informatie over het gebruik van functie-statesets voor stijlfuncties in Kaarten weergavekaart.
Notitie
Net als tegelsets heeft het wijzigen van een gegevensset geen invloed op de bestaande functie-stateset en het verwijderen van een functie-stateset heeft geen invloed op de gegevensset waaraan deze is gekoppeld.
Plattegronden gebruiken
API V2-Get kaarttegel weergeven
De Azure Kaarten Render V2-Get Map Tile-API is uitgebreid ter ondersteuning van Creator-tegelsets.
Toepassingen kunnen de Render V2-Get Map Tile-API gebruiken om tegelsets aan te vragen. De tegelsets kunnen vervolgens worden geïntegreerd in een kaartbesturingselement of SDK. Zie Indoor Kaarten Module voor een voorbeeld van een kaartbesturingselement dat gebruikmaakt van de Render V2-service.
Web Feature Service API
U kunt de api Web Feature Service (WFS) gebruiken om query's uit te voeren op gegevenssets. WFS volgt de Open Geospatial Consortium API-functies. U kunt de WFS-API gebruiken om query's uit te voeren op functies in de gegevensset zelf. U kunt bijvoorbeeld WFS gebruiken om alle middelgrote vergaderruimten van een specifieke faciliteit en verdiepingsniveau te vinden.
Alias-API
Creator-services zoals Conversie, Gegevensset, Tegelset en Functietoestand retourneren een id voor elke resource die is gemaakt op basis van de API's. Met de Alias-API kunt u een alias toewijzen om te verwijzen naar een resource-id.
Plattegrondmodule
De Azure Kaarten Web SDK bevat de module Indoor Kaarten. Deze module biedt uitgebreide functies voor de Azure Kaarten Map Control bibliotheek. De module Indoor Kaarten geeft plattegronden weer die zijn gemaakt in Creator. Het integreert widgets, zoals vloer kiezen, die gebruikers helpen om de verschillende verdiepingen te visualiseren.
U kunt de module Indoor Kaarten gebruiken om webtoepassingen te maken die indoor kaartgegevens integreren met andere Azure Kaarten services. De meest voorkomende toepassingsinstellingen zijn het toevoegen van kennis van andere kaarten , zoals wegen, afbeeldingen, weer en doorvoer, aan plattegronden.
De module Indoor Kaarten ondersteunt ook dynamische kaartstijlen. Zie Use the Indoor Map module (De module Indoorkaart gebruiken) voor een stapsgewijs overzicht van het implementeren van de functie-stateset dynamische stijlen in een toepassing.
Azure Kaarten-integratie
Wanneer u begint met het ontwikkelen van oplossingen voor plattegronden, kunt u manieren ontdekken om bestaande Azure-Kaarten integreren. U kunt bijvoorbeeld assettracking- of veiligheidsscenario's implementeren met behulp van de Azure Kaarten Geofence-API met plattegronden van Creator. U kunt bijvoorbeeld de Geofence-API gebruiken om te bepalen of een werkster specifieke binnenruimten binnenkomt of verlaat. Zie deze zelfstudie over ruimtelijke IoT-analyse voor meer informatie over het verbinden van Azure Kaarten met IoT-telemetrie.
Gegevensonderhoud
U kunt de Azure Kaarten Creator List, Update en Delete API gebruiken om uw gegevenssets, tegelsets en functie statesets weer te geven, bij te werken en te verwijderen.
Notitie
Wanneer u een lijst met items bekijkt om te bepalen of u ze wilt verwijderen, moet u rekening houden met de impact van deze verwijdering op alle afhankelijke API's of toepassingen. Als u bijvoorbeeld een tegelset verwijdert die door een toepassing wordt gebruikt met de Api Voor kaarttegel renderen V2-Get,kan de toepassing die tegelset niet weergeven.
Voorbeeld: Een gegevensset bijwerken
In het volgende voorbeeld ziet u hoe u een gegevensset bij werkt, een nieuwe tegelset maakt en een oude tegelset verwijdert:
- Volg de stappen in de secties Upload tekenpakket en Een tekenpakket converteren om het nieuwe tekenpakket te uploaden en te converteren.
- Gebruik de API voor het maken van gegevenssets om de geconverteerde gegevens toe te appen aan de bestaande gegevensset.
- Gebruik de Tegelset API maken om een nieuwe tegelset te genereren uit de bijgewerkte gegevensset.
- Sla de nieuwe tegelsetId op voor de volgende stap.
- Als u de visualisatie van de bijgewerkte campusgegevensset wilt inschakelen, moet u de tegelset-id in uw toepassing bijwerken. Als de oude tegelset niet meer wordt gebruikt, kunt u deze verwijderen.