Geolocatie toevoegen
Geolocatie dient ter aanduiding van de werkelijke geografische locatie van een object. Geolocaties zijn nauw verwant met het gebruik van plaatsingssystemen, maar leggen een grotere nadruk op het vaststellen van een zinvolle locatie (bijvoorbeeld een straatnaam) in plaats van alleen een reeks geografische coördinaten. Het woord geolocatie kan ook betrekking hebben op de breedte- en lengtegraadcoördinaten van een bepaalde locatie.
Een formulier kan worden geconfigureerd voor weergave van een kaartbesturingselement om een bestaande locatie als een speld op een kaart weer te geven of om aan de gebruiker de mogelijkheid te bieden een locatie op te geven.
Als het formulier of het veld Adresregel bewerkbaar is en dit veld leeg is, wordt gebruikers bij het laden van de webpagina gevraagd of ze hun locatie willen delen. Als ze ervoor kiezen hun locatie te delen, wordt de kaart vervolgens bijgewerkt met hun momenteel gedetecteerde locatie. De gebruiker kan de locatie van de speld verfijnen door deze te slepen. Als gebruikers ervoor kiezen om de locatie niet te delen, kunnen ze de locatie in de daartoe bestemde velden handmatig opgeven. Er wordt dan een query uitgevoerd op de kaartservice om de locatie te zoeken en de breedte- en lengtegraad worden bijgewerkt en de plaats van de speld op de kaart wordt dienovereenkomstig aangepast.
Geolocatie toevoegen
Om de geolocatiefunctionaliteit toe te voegen aan een formulier, moeten de volgende taken worden uitgevoerd.
Formulieren aanpassen
Bewerk het basisformulier met de formulierontwerper en breng de volgende wijzigingen aan:
Maak een nieuwe sectie en geef een geschikt label op, bijvoorbeeld Kaart. Deze sectie bevat de kaart.
Stel de naam van de sectie in op sectiekaart of een naam die eindigt met sectiekaart, bijvoorbeeld contososectiekaart. Deze naam is van belang omdat de formulierengine zoekt naar een sectie met deze naam om te bepalen wanneer een kaart moet worden weergegeven.
Voeg een nieuw of bestaand veld toe waarin het opgemaakte adres wordt opgeslagen en voeg het toe aan de sectie Kaart die in de vorige stap is gemaakt.
Maak een nieuwe sectie en geef een geschikt label op, bijvoorbeeld Locatie. Deze sectie bevat de adresvelden voor de geselecteerde locatie.
Voeg de vereiste adresvelden aan de sectie Locatie toe die in de vorige stap is gemaakt:
- Adresregel
- Plaats
- District
- Provincie
- Land/regio
- Postcode
- Breedtegraad
- Lengtegraad
Het resulterende formulier moet er ongeveer als volgt uitzien. U kunt verschillende weergavenamen voor deze velden kiezen. U kunt er ook voor kiezen deze secties op de gewenste manier op te maken.
Site-instellingen
Voor geolocatie met kaartfunctionaliteit in formulieren zijn configuratie-instellingen vereist om aanvragen met het REST-eindpunt van de kaartservice te voltooien. De volgende site-instellingen worden gebruikt om de locatieservice te configureren.
| Naam | Waarde |
|---|---|
| Bingmaps/credentials | Unieke sleutel om aanvragen voor de API Bing Maps te verifiëren. Bezoek www.bingmapsportal.com om een Bing Maps-account te maken en een sleutel te verkrijgen. Vereist. |
| Bingmaps/restURL | URL naar de REST-API Bing Maps. Optioneel. Als een waarde niet is opgegeven, wordt de standaardwaarde https://dev.virtualearth.net/REST/v1/Locations gebruikt. |
Veldconfiguraties
Voor het kaartbesturingselement van het formulier is aanvullende configuratie vereist om aan te geven wat de id's van de verschillende locatievelden zijn, zodat er waarden aan kunnen worden toegewezen of van opgehaald. De configuratie is afhankelijk van het type beheerd formulier.
Zie voor basisformulieren: Geolocatieconfiguratie voor basisformulieren.
Zie voor formulieren voor meerdere stappen: Geolocatieconfiguratie voor formulieren voor meerdere stappen.