Maker voor indoorkaarten

Notitie

Buitengebruikstelling van Azure Maps Creator

De indoor kaartservice van Azure Maps Creator is nu afgeschaft en wordt buiten gebruik gesteld op 30-9-25. Zie einde levensduuraankondiging van Azure Maps Creator voor meer informatie.

In dit artikel worden concepten en hulpprogramma's geïntroduceerd die van toepassing zijn op Azure Maps Creator. We raden u aan dit artikel te lezen voordat u de Azure Maps Creator-API en SDK gaat gebruiken.

U kunt Creator gebruiken om toepassingen te ontwikkelen met kaartfuncties die zijn gebaseerd op indoorkaartgegevens. In dit artikel wordt beschreven hoe u uw kaartgegevens uploadt, converteert, maakt en gebruikt. Normaal gesproken wordt de werkstroom voltooid door twee verschillende persona's met verschillende expertisegebieden en verantwoordelijkheidsgebieden:

• Mapmaker: verantwoordelijk voor het cureren en voorbereiden van de kaartgegevens.
• Maker kaartgegevensgebruiker: maakt gebruik van klanttoewijzingsgegevens in toepassingen.

In het volgende diagram ziet u de hele werkstroom.

Azure Maps Creator maken

Als u Creator-services wilt gebruiken, moet er een Azure Maps Creator-resource worden gemaakt en gekoppeld aan een Azure Maps-account met de prijscategorie Gen 2. Zie Azure Maps Creator beheren voor informatie over het maken van een Azure Maps Creator-resource in Azure.

Tip

Zie de sectie Creator in Prijzen van Azure Maps voor informatie over prijzen.

Verificatie van maker

Creator neemt de IAM-instellingen (Access Control) van Azure Maps over. Alle API-aanroepen voor gegevenstoegang moeten worden verzonden met verificatie- en autorisatieregels.

Gebruiksgegevens van makers worden opgenomen in uw Azure Maps-gebruiksgrafieken en activiteitenlogboek. Zie Verificatie beheren in Azure Maps voor meer informatie.

Belangrijk

U wordt aangeraden het volgende te gebruiken:

• Microsoft Entra ID in alle oplossingen die zijn gebouwd met een Azure Maps-account met behulp van Creator-services. Zie Microsoft Entra-verificatie voor meer informatie over Microsoft Entra-id.

• Instellingen voor op rollen gebaseerd toegangsbeheer. Met behulp van deze instellingen kunnen kaartmakers fungeren als de rol Inzender voor Azure Maps-gegevens en kunnen gebruikers van creator-kaartgegevens fungeren als de rol Gegevenslezer van Azure Maps. Zie Autorisatie met op rollen gebaseerd toegangsbeheer voor meer informatie.

Typen creator-gegevensitems

Creator-services maken, opslaan en gebruiken verschillende gegevenstypen die in de volgende secties worden gedefinieerd en besproken. Een makergegevensitem kan van de volgende typen zijn:

• Geconverteerde gegevens
• Gegevensset
• Tegelset
• stijl
• Toewijzingsconfiguratie
• Routeset

Een tekenpakket uploaden

Maker verzamelt indoorkaartgegevens door een geüpload tekenpakket te converteren. Het tekenpakket vertegenwoordigt een geconstrueerde of geremodelleerde faciliteit. Zie Tekenpakketvereisten voor informatie over de vereisten voor tekenpakketten.

Volg de stappen die worden beschreven in het artikel Gegevensregister maken om het tekenpakket te uploaden naar uw Azure-opslagaccount en registreer het vervolgens in uw Azure Maps-account.

Belangrijk

Noteer de unieke id (udid)-waarde die u nodig hebt. Het udid is vereist om het geüploade pakket te converteren naar indoorkaartgegevens.

Een tekenpakket converteren

Met de conversieservice wordt een geüpload tekenpakket geconverteerd naar gegevens van een indoorkaart. De conversieservice valideert ook het pakket. Validatieproblemen worden ingedeeld in twee typen:

• Fouten: Als er fouten worden gedetecteerd, mislukt het conversieproces. Wanneer er een fout optreedt, biedt de conversieservice een koppeling naar de zelfstandige webtoepassing Azure Maps-tekeningfout visualiseren . U kunt tekenenfout visualiseren gebruiken om waarschuwingen en fouten van tekenpakketten te controleren die zijn opgetreden tijdens het conversieproces. 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 bekijken en op te lossen. Een waarschuwing betekent dat een deel van de conversie is genegeerd of automatisch is opgelost. Als u de waarschuwingen niet kunt oplossen, kunnen er fouten optreden in latere processen. Zie Waarschuwingen en fouten van tekenpakketten voor meer informatie.

Gegevens binnenkaart maken

Azure Maps Creator biedt de volgende services die ondersteuning bieden voor het maken van kaarten:

• 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.
• Aangepaste stylingservice. Gebruik de stijlservice of visuele stijleditor om de visuele elementen van een indoorkaart aan te passen.
• Wayfinding-service. Gebruik de wayfinding-API om een pad te genereren tussen twee punten binnen een faciliteit. Gebruik de routeset-API om de gegevens te maken die de wayfinding-service nodig heeft om paden te genereren.

Gegevenssets

Een gegevensset is een verzameling indoorkaartfuncties. De indoorkaartfuncties vertegenwoordigen faciliteiten die zijn gedefinieerd in een geconverteerd tekenpakket. Nadat u een gegevensset hebt gemaakt met de gegevenssetservice, kunt u een willekeurig aantal tegelsets maken.

Ontwikkelaars kunnen op elk gewenst moment de gegevenssetservice gebruiken om faciliteiten aan een bestaande gegevensset toe te voegen of te verwijderen. Zie de toevoegopties 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 weergeven, kunt u meerdere tegelsets maken op basis van dezelfde gegevensset. U kunt bijvoorbeeld één tegelset maken met meubels en apparatuur, en een andere tegelset zonder meubels 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 kaartweergave. Tegelsetmetagegevens bevatten bijvoorbeeld een minimum- en maximumzoomniveau voor de tegelset. De metagegevens bieden ook een begrenzingsvak waarmee de geografische omvang van de tegelset wordt gedefinieerd. Een toepassing kan een begrenzingsvak gebruiken om het juiste middelpunt programmatisch in te stellen. Zie De tegelsetlijst voor meer informatie over metagegevens van tegelset.

Nadat een tegelset is gemaakt, wordt deze opgehaald met behulp van de Render-service.

Als een tegelset verouderd raakt en niet meer nuttig is, kunt u de tegelset verwijderen. Zie Gegevensonderhoud voor informatie over het verwijderen van tegelsets.

Notitie

Een tegelset is onafhankelijk van de gegevensset waaruit deze is gemaakt. Als u tegelsets maakt op basis van een gegevensset en deze gegevensset vervolgens bijwerkt, worden de tegelsets niet bijgewerkt.

Als u wijzigingen in een gegevensset wilt weergeven, moet u nieuwe tegelsets maken. Als u een tegelset verwijdert, wordt de gegevensset ook niet beïnvloed.

Aangepaste stijl (preview)

Een stijl definieert het uiterlijk van een kaart. Hiermee definieert u welke gegevens moeten worden getekend, de volgorde waarin u deze wilt tekenen en hoe u de gegevens kunt stylen bij het tekenen. Azure Maps Creator-stijlen ondersteunen de MapLibre-standaard voor stijllagen en sprites.

Wanneer u een tekenpakket converteert nadat u het hebt geüpload naar uw Azure Maps-account, worden standaardstijlen toegepast op de elementen van uw kaart. Met de aangepaste stijlservice kunt u het visuele uiterlijk van uw kaart aanpassen. U kunt dit doen door de JSON-stijl handmatig te bewerken en deze te importeren in uw Azure Maps-account met behulp van de stijl - HTTP-aanvraag maken , maar de aanbevolen methode is om de visuele stijleditor te gebruiken. Zie Aangepaste stijlen voor indoorkaarten maken voor meer informatie.

Voorbeeldlaag in het style.json-bestand:

{
	"id": "indoor_unit_gym_label",
	"type": "symbol",
	"filter": ["all", ["has","floor0"], ["any", ["==", "categoryName", "room.gym"]]],
	"layout": {
		"visibility": "none",
		"icon-image": "gym",
		"icon-size": {"stops": [[17.5, 0.7], [21, 1.1]]},
		"symbol-avoid-edges": true,
		"symbol-placement": "point",
		"text-anchor": "top",
		"text-field": "{name}",
		"text-font": ["SegoeFrutigerHelveticaMYingHei-Medium"],
		"text-keep-upright": true,
		"text-letter-spacing": 0.1,
		"text-offset": [0, 1.05],
		"text-size": {"stops": [[18, 5], [18.5, 6.5], [19, 8], [19.5, 9.5], [20, 11]]}
	},
	"metadata": {"microsoft.maps:layerGroup": "labels_indoor"},
	"minzoom": 17.5,
	"paint": {
		"text-color": "rgba(0, 0, 0, 1)",
		"text-halo-blur": 0.5,
		"text-halo-color": "rgba(255, 255, 255, 1)",
		"text-halo-width": 1,
		"text-opacity": ["step", ["zoom"], 0, 18, 1]
	},
	"source-layer": "Indoor unit"
},

Laageigenschappen	Description
id	De naam van de laag
type	Het renderingtype voor deze laag. Enkele van de meest voorkomende typen zijn: fill: Een opgevulde veelhoek met een optionele rand met pennenstreken. Lijn: Een lijn met lijnen. Symbool: een pictogram of een tekstlabel. fill-extrusion: Een geëxtrudeerde (3D) veelhoek.
filter	Alleen functies die voldoen aan de filtercriteria worden weergegeven.
indeling	Indelingseigenschappen voor de laag.
minzoom	Een getal tussen 0 en 24 dat het minimale zoomniveau voor de laag vertegenwoordigt. Op zoomniveaus die kleiner zijn dan de minzoom, is de laag verborgen.
schilderen	Standaardverfeigenschappen voor deze laag.
bronlaag	Een bron levert de gegevens, van een vectortegelbron, die op een kaart worden weergegeven. Vereist voor vectortegelbronnen; verboden voor alle andere brontypen, met inbegrip van GeoJSON-bronnen.

Toewijzingsconfiguratie

De kaartconfiguratie is een matrix met configuraties. Elke configuratie bestaat uit een basemap en een of meer lagen, elke laag die bestaat uit een + stijltegelset tuple.

De kaartconfiguratie wordt gebruikt wanneer u De Indoor Manager van een kaartobject instantiëren bij het ontwikkelen van toepassingen in Azure Maps. Er wordt naar verwezen met behulp van de mapConfigurationId of alias. Toewijzingsconfiguraties zijn onveranderbaar. Wanneer u wijzigingen aanbrengt in een bestaande toewijzingsconfiguratie, wordt er een nieuwe toewijzingsconfiguratie gemaakt, wat resulteert in een andere mapConfingurationId. Wanneer u een kaartconfiguratie maakt met behulp van een alias die al door een bestaande toewijzingsconfiguratie wordt gebruikt, verwijst deze naar de nieuwe toewijzingsconfiguratie.

De volgende JSON is een voorbeeld van een standaardtoewijzingsconfiguratie. Zie de volgende tabel voor een beschrijving van elk element van het bestand:

{
    "version": 1.0,
    "description": "This is the default Azure Maps map configuration for facility ontology tilesets.",
    "defaultConfiguration": "indoor_light",
    "configurations": [
        {
            "name": "indoor_light",
            "displayName": "Indoor light",
            "description": "A base style for Azure Maps.",
            "thumbnail": "indoor_2022-01-01.png",
            "baseMap": "microsoft_light",
            "layers": [
                {
                    "tilesetId": "fa37d225-924e-3f32-8441-6128d9e5519a",
                    "styleId": "microsoft-maps:indoor_2022-01-01"
                }
            ]
        },
        {
            "name": "indoor_dark",
            "displayName": "Indoor dark",
            "description": "A base style for Azure Maps.",
            "thumbnail": "indoor_dark_2022-01-01.png",
            "baseMap": "microsoft_dark",
            "layers": [
                {
                    "tilesetId": "fa37d225-924e-3f32-8441-6128d9e5519a",
                    "styleId": "microsoft-maps:indoor_dark_2022-01-01"
                }
            ]
        }
    ]
}

Eigenschappen van stijlobject	Description
Naam	De naam van de stijl.
displayName	De weergavenaam van de stijl.
beschrijving	De door de gebruiker gedefinieerde beschrijving van de stijl.
thumbnail	Gebruik deze optie om de miniatuur op te geven die wordt gebruikt in de stijlkiezer voor deze stijl. Zie het besturingselement stijlkiezer voor meer informatie.
baseMap	Hiermee stelt u de basiskaartstijl in.
Lagen	De lagenmatrix bestaat uit een of meer tegelset + style tuples, die elk een laag van de kaart zijn. Hierdoor kunnen meerdere gebouwen op een kaart worden weergegeven, elk gebouw in een eigen tegelset.

Aanvullende informatie

• Zie Aangepaste stijlen maken voor indoorkaarten voor meer informatie over het wijzigen van stijlen met behulp van de stijleditor.
• Zie de stijl in de naslaginformatie over de Rest API van Maps Creator voor meer informatie over de rest-API van de stijl .
• Zie Creator - rest API voor toewijzingsconfiguratie voor meer informatie over de REST API voor kaartconfiguratie.

Wayfinding (preview)

Met de Wayfinding-service kunt u uw klanten het kortste pad tussen twee punten binnen een faciliteit bieden. Zodra u uw indoorkaartgegevens hebt geïmporteerd en uw gegevensset hebt gemaakt, kunt u deze gebruiken om een routeset te maken. De routeset bevat de gegevens die nodig zijn om paden tussen twee punten te genereren. De wayfinding service houdt rekening met zaken zoals de minimale breedte van openingen en kan eventueel liften of trappen uitsluiten bij het navigeren tussen niveaus als gevolg hiervan.

Creator wayfinding wordt mogelijk gemaakt door Havok.

Wegwijspaden

Wanneer een pad voor het bepalen van een manier is gegenereerd, wordt het kortste pad tussen twee punten in de opgegeven faciliteit gevonden. Elke verdieping in de reis wordt weergegeven als een apart been, net als elke trap of lift die wordt gebruikt om tussen de verdiepingen te schakelen.

Het eerste been van het pad kan bijvoorbeeld afkomstig zijn van de oorsprong naar de lift op die verdieping. Het volgende been is de lift en dan is het laatste been het pad van de lift naar de bestemming. De geschatte reistijd wordt ook berekend en geretourneerd in de JSON van het HTTP-antwoord.

Structuur

Om te kunnen werken, moeten de faciliteitgegevens een structuur bevatten. De wayfinding-service berekent het kortste pad tussen twee geselecteerde punten in een faciliteit. De service maakt het pad door te navigeren rond structuren, zoals muren en andere ondoordringbare structuren.

Verticale penetratie

Als de geselecteerde oorsprong en bestemming zich op verschillende verdiepingen bevinden, bepaalt de wayfinding-service welke verticalPenetration-objecten , zoals trappen of liften, beschikbaar zijn als mogelijke paden voor het verticaal navigeren tussen niveaus. Standaard wordt de optie die resulteert in het kortste pad gebruikt.

De Wayfinding-service omvat trappen of liften in een pad op basis van de waarde van de eigenschap van de verticale penetratie direction . Zie verticalPenetration in het artikel Facility Ontology voor meer informatie over de richtingeigenschap. Zie de avoidFeatures en minWidth eigenschappen in de api-documentatie voor wayfinding voor meer informatie over andere factoren die van invloed kunnen zijn op de padselectie tussen verdiepingsniveaus.

Zie voor meer informatie het artikel over hoe u de service voor indoorkaarten definieert.

Indoorkaarten gebruiken

Render - Tegel-API voor kaart ophalen

De API [Render - Get Map Tile] van Azure Maps is uitgebreid ter ondersteuning van Creator-tegelsets.

Toepassingen kunnen de Render - Get Map Tile API gebruiken om tegelsets aan te vragen. De tegelsets kunnen vervolgens worden geïntegreerd in een kaartbeheer of SDK. Zie Indoor Maps Module voor een voorbeeld van een kaartbeheer dat gebruikmaakt van de Render-service.

Web Feature Service-API

U kunt de webfunctieservice (WFS) gebruiken om query's uit te voeren op gegevenssets. WFS volgt de open georuimtelijke 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 verdieping te vinden.

Alias-API

Creator-services zoals Conversie, Gegevensset en Tegelset 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 Maps Web SDK bevat de module Indoor Maps. Deze module biedt uitgebreide functionaliteiten voor de Azure Maps Map Control-bibliotheek . De module Indoor Maps geeft indoorkaarten weer die zijn gemaakt in Creator. Het integreert widgets zoals vloerkiezer waarmee gebruikers de verschillende verdiepingen kunnen visualiseren.

U kunt de Indoor Maps-module gebruiken om webtoepassingen te maken die indoorkaartgegevens integreren met andere Azure Maps-services. De meest voorkomende toepassingsinstellingen zijn het toevoegen van kennis van andere kaarten, zoals wegen, afbeeldingen, weer en doorvoer, aan indoorkaarten.

De module Indoor Maps biedt ook ondersteuning voor dynamische kaartstijlen voor meer informatie. Zie Uw indoorkaarten verbeteren met de stijl van realtime kaartfuncties.

Integratie van Azure Maps

Wanneer u oplossingen voor indoorkaarten gaat ontwikkelen, kunt u manieren ontdekken om bestaande Mogelijkheden van Azure Maps te integreren. U kunt bijvoorbeeld assettracking- of veiligheidsscenario's implementeren met behulp van de Geofence-service met Creator-indoorkaarten. U kunt bijvoorbeeld de Geofence-API gebruiken om te bepalen of een werknemer specifieke binnengebieden binnenkomt of verlaat.

Gegevensonderhoud

U kunt de Azure Maps Creator List, Update en Delete-API gebruiken om uw gegevenssets en tegelsets 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 gevolgen van die verwijdering voor alle afhankelijke API's of toepassingen. Als u bijvoorbeeld een tegelset verwijdert die wordt gebruikt door een toepassing met behulp van de API [Render - Get Map Tile], kan de toepassing die tegelset niet weergeven.

Voorbeeld: Een gegevensset bijwerken

In het volgende voorbeeld ziet u hoe u een gegevensset bijwerkt, een nieuwe tegelset maakt en een oude tegelset verwijdert:

1. Volg de stappen in de secties Een tekenpakket uploaden en een tekenpakket converteren om het nieuwe tekenpakket te uploaden en te converteren.
2. Gebruik Gegevensset maken om de geconverteerde gegevens toe te voegen aan de bestaande gegevensset.
3. Gebruik Tegelset Maken om een nieuwe tegelset te genereren uit de bijgewerkte gegevensset.
4. Sla de nieuwe tilesetId op voor de volgende stap.
5. Werk de tegelset-id in uw toepassing bij om de visualisatie van de bijgewerkte campusgegevensset in te schakelen. Als de oude tegelset niet meer wordt gebruikt, kunt u deze verwijderen.