Routes tussen tussenpuntspelden op een kaart berekenen (preview)

[Dit onderwerp maakt deel uit van de voorlopige documentatie en kan nog veranderen.]

Het map-besturingselement in een canvas-app kan tussenpuntspelden toevoegen met behulp van gegevens die zijn geïmporteerd uit een tabel in een Excel-werkmap. De besturing kan routes tussen tussenpunten berekenen, tussenpunten opnieuw ordenen en een route herberekenen om de reistijd of afstand te verbeteren.

Belangrijk

• Dit is een preview-functie.
• Preview-functies zijn niet bedoeld voor productiegebruik en bieden mogelijk beperkte functionaliteit. Deze functies zijn beschikbaar voor een officiële release zodat klanten vroeg toegang kunnen krijgen en feedback kunnen geven.

U hebt een gegevensbron nodig die een benoemde tabel bevat met de volgende kolommen. Elke kolom komt overeen met een geavanceerde eigenschap van het besturingselement map. Elke rij is als een tussenpunt op de kaart vastgezet.

Kolomnaam	Komt overeen met	Vereist
Naam (of label)	RouteWaypointsLabels	Optioneel
Lengtegraad	RouteWaypointsLongitudes	Optioneel (vereist als Adres niet is opgegeven)
Breedtegraad	RouteWaypointsLatitudes	Optioneel (vereist als Adres niet is opgegeven)
Adres	RouteWaypointsAddresses	Optioneel (vereist als Lengtegraad en Breedtegraad niet zijn opgegeven)

Notitie

Alle eigenschappen zijn technisch optioneel. Er moet echter ten minste één adres of een breedtegraad/lengtegraad-paar worden opgegeven om de tussenpuntlocatie te tekenen.

Tussenpuntspelden importeren uit een Excel-tabel

In dit voorbeeld importeren we tussenpuntgegevens uit een Excel-tabel met de naam TestData.

Een gegevensbron maken

1. Maak een tabel in Excel met de volgende gegevens. Geef de tabel de naam TestData.

   Name	Lengtegraad	Breedtegraad	Adres
   Werk	-122.156481	47.663448	1 Microsoft Way, Redmond, WA 98052
   Ontmoeten	-122.221037	47.57137
   Zwemmen	-122.144133	47.600373
   Tennis	-122.137265	47.616115

   De tabel zou er ongeveer als volgt uit moeten zien:

   

2. Sla de werkmap op in uw OneDrive voor Bedrijven en sluit het bestand.

De gegevensbron aan een map-besturingselement binden

1. Een canvas-app maken. Zorg dat deze voldoet aan de georuimtelijke vereisten.

2. Een map-besturingselement invoegen.

3. Schakel op het tabblad Eigenschappen van het besturingselement het vakje Tussenpunten op route (items) in en typ excel.

   

4. Selecteer Importeren uit Excel.

5. Navigeer naar uw OneDrive voor Bedrijven en selecteer de Excel-werkmap die u eerder hebt opgeslagen.

6. Selecteer de tabel TestData en selecteer Verbinden.

   

7. Vind op het tabblad Geavanceerd RouteWaypointsLabels, RouteWaypointsLatitudes, RouteWaypointsLongitudes en RouteWaypointsAddresses en voer de naam van de overeenkomende kolom in de tabel in. (Voer in dit voorbeeld Naam in RouteWaypointsLabels, Latitude in RouteWaypointsLatitudes, enzovoort in.) Plaats de kolomnaam tussen aanhalingstekens.

   Notitie

   Adres is uitwisselbaar met Breedtegraad en Lengtegraad. Als Breedtegraad en Lengtegraad zijn opgegeven, wordt Adres niet gebruikt. Als Adres is opgegeven, zijn Breedtegraad en Lengtegraad niet nodig. Er is een limiet aan het aantal tussenpunten dat kan worden weergegeven bij het gebruik van een adres, dus gebruik indien mogelijk de breedte- en lengtegraad.

Spelden verschijnen op de kaart op de locaties die zijn aangeduid door de coördinaten of adressen in de tabel. Als de tabel labels bevatte, zijn de spelden gelabeld. De spelden zijn genummerd in de volgorde waarin de tussenpuntlocaties in de tabel worden weergegeven.

Routes tussen de tussenpunten berekenen.

Met het map-besturingselement geselecteerd, opent u het tabblad Eigenschappen en schakelt u Routering inschakelen in.

Het besturingselement berekent routes tussen de vastgezette tussenpunten.

Notitie

Standaard worden de middelste tussenpunten opnieuw geordend in het map-besturingselement om de reistijd of -afstand te verkorten. Het eerste en laatste tussenpunt worden beschouwd als de oorsprong en bestemming en kunnen niet opnieuw worden gerangschikt. Om de tussenpunten in de volgorde van de gegevensbron te houden, zet u de eigenschap Maintain waypoint order aan.

Eigenschappen

Wijzig hoe een route wordt berekend met behulp van eigenschappen.

Eigenschap	Omschrijving	Type	Tab
Enable routing	Berekent routes tussen tussenpunten.	Booleaans	Eigenschappen; Geavanceerd: UseRouting
Maintain waypoint order	Bepaalt of een berekende route tussenpunten in de opgegeven volgorde van de gegevensbron handhaaft.	Booleaans	Eigenschappen; Geavanceerd: RouteMaintainOrder
Optimize route	Bepaalt of een berekende route is geoptimaliseerd voor afstand, tijd of niet is geoptimaliseerd.	Vervolgkeuzelijst	Eigenschappen; Geavanceerd: RouteOptimization
Route travel mode	Bepaalt of een route wordt berekend voor een auto of een vrachtwagen, waarvoor mogelijk bruggen met bepaalde hoogte- of gewichtsbeperkingen moeten worden vermeden.	Vervolgkeuzelijst	Eigenschappen; Geavanceerd: RouteTravelMode
Show route pins	Bepaalt of spelden worden weergegeven boven de route-tussenpunten.	Booleaans	Eigenschappen; Geavanceerd: ShowRoutePins

Uitvoereigenschappen

Sommige eigenschappen komen pas beschikbaar als een berekende route verandert. Deze uitvoereigenschappen worden geplaatst in het object RouteDirection. De gebeurtenis OnRouteDirectionChange is een aanbevolen manier om de uitvoer in andere besturingselementen te gebruiken of om de app-ervaring aan te passen.

Eigenschappen	Omschrijving	Type	Tab
OnRouteDirectionChange	Bevat code die wordt uitgevoerd wanneer de route wordt gewijzigd.	Gebeurtenis	Geavanceerd
RouteDirection	Beschrijft de uitvoer van de route: LengthInMeters - De lengte in meters van de gehele route TravelTimeInSeconds - De verwachte reistijd in seconden van de gehele route RouteGeoJSON - Een tekenreeks met de route in GeoJSON-indeling RouteLegs - Een tabel met beschrijvingen van elke etappe van de route: Index - Een getal dat de volgorde van de etappe in de route weergeeft LengthInMeters - De lengte in meters van de etappe TravelTimeInSeconds - De verwachte reistijd in seconden van de etappe StartLabel: het label van het startpunt van de etappe StartLatitude: de breedtegraag van het startpunt van de etappe StartLongitude: de lengtegraag van het startpunt van de etappe StartAddress: het adres van het startpunt van de etappe EndLabel: het label van het eindpunt van de etappe EndLatitude: de lengtegraad van het eindpunt van de etappe EndLongitude: de breedtegraad van het eindpunt van de etappe EndAddress: het adres van het eindpunt van de etappe OrderedWaypoints - Een tabel met beschrijving van elk tussenpunt na het rangschikken van de tussenpunten: Index - Een getal dat de volgorde van het tussenpunt in de route weergeeft Label - Het label van het tussenpunt Latitude: de breedtegraad van het tussenpunt Longitude: de lengtegraad van het tussenpunt Address: het adres van het tussenpunt	Object	Niet van toepassing (alleen uitvoereigenschap)

Zie ook

Interactive map-besturingselement