Map&Route is eenvoudig binnen uw website integreren.
Een manier is door simpelweg te linken naar de Map&Route kaart of route pagina.
Linken naar een Map&Route pagina kan alleen als de URL met de juiste parameters wordt meegegeven.
De parameters kunnen direct aan de URL worden meegegeven of via een HTML-form.
De pagina's worden alleen correct weergegeven als de juiste parameters worden meegegeven.
Zo verwacht elke Map&Route aanroep dat in ieder geval dat uw aanroep wordt geidentificeerd.
Daarnaast zijn in het geval van een aanroep van een Map&Route plattegrond de parameters voor opgave van het adres van een locatie van belang.
Bij de aanroep van een Map&Route routebeschrijving dienen daarnaast ook de parameters van een vertrek adres te worden meegegeven.
Voor het vormgeven van de Map&Route pagina's kan gebruik worden gemaakt van de beschikbare extra parameters voor opgave van bijvoorbeeld een url naar een css bestand of een afbeelding van een logo.
Over het aanroepen van een locatie
Een locatie kan in principe alleen in kaart worden weergegeven als zijn geografische positie bekend is. Map&Route biedt de mogelijkheid de locatie met alleen adresgegevens. Hierbij wordt op basis van het opgegeven adres dynamisch gezocht naar de positie uit de meest recente geronemeerde geographische databases (o.a. TeleAtlas, Navtech).
Als het adres van de locatie niet constant wijzigt dan wordt aangeraden aanroep Map&Route met de scriptgenerator te bepalen.
Map&Route kan ook worden aangeroepen indien alleen de positie van de locatie bekend is.
Een locatie wordt dus door Map&Route in principe herkend als:
- Adres met onbekende positie,
- Positie zonder adres.
Note: indien het adres niet wordt gevonden door Locatienet dan wordt door Map&Route een foutmelding hiervan gegeven.
Mijn Map&Route
Bezoekers van uw website kunnen Map&Route gebruiken voor een plattegrond of route van uw locatie(s). Dit kan alleen als u een link of formulier binnen uw website opneemt waarmee Map&Route wordt aangeroepen.
Om de Map&Route pagina's juist te kunnen weer te geven moeten een aantal parameters aan de URL te worden meegeven:
config_id: de code die heeft ontvangen waarmee uw aanroep kan worden geidentificeerd.
Daarnaast is zijn gegevens van de locatie nodig: street, postcode, city, country
config_id = 7230
street = Dam 1 ( straatnaam + huisnummer)
postcode = (postcode niet opgegeven)
city= Amsterdam (plaatsnaam)
country=NL (landcode. Landcode is niet nodig bij adressen in Nederland)
Aan de basis aanroep kunnen ook extra parameters worden meegeven ten behoeve van de vormgeving (zie later)
Een dynamische adres Kent u slechts het adres van de locatie dan kan de bepaling van de positie aan de Locatienet™Map&Route worden overgelaten door in de aanroep het adres mee te geven. De Locatienet™Map&Route zal dan proberen de juiste positie te bepalen. Wordt de positie volledig gevonden dan zal de Locatienet™Map&Route op basis hiervan de plattegrond/routebeschrijving tonen, anders zal er een lijst worden gegeven waaruit de gebruiker het meest overeenkomende adres dient te kiezen.
De parameters waarmee de Locatienet™Map&Route aan de hand van een adres dynamisch de positie bepaalt, zijn:
street: de naam van de straat + huisnummer van de locatie
zipcode: de postcode van de locatie
city: de naam van de plaats van de locatie
country: de code van het land van de locatie
Bijvoorbeeld:
Het adres is Dam 1 in Amsterdam, Nederland.
De parameters van de aanroep zijn dan:
street=Dam+1
city=Amsterdam
country=NL
Bij aanroep van getroute.asp heten de parameters respectievelijk street_stop, postcode_stop, city_stop, country_stop
Een dynamische positie
Ook al is het adres van de locatie onbekend maar de positie wel bekend dan kan de juiste plattegrond worden opgeroepen. De Locatienet™Map&Route verwacht een positie in Geodecimaal Lattitude-Longitude WGS84. De xy-coordinaten van de positie worden meegegeven aan de parameter 'address' als [x]_[y]
Bijvoorbeeld:
Longitude WGS84: 4 graden, 20 minuten en 53 seconde --> 4.34806 --> x: 434806
Lattitude WGS84: 52 graden, 3 minuten en 21 seconden --> 52.05583 --> y: 5205583
De conversie van graden naar radialen is:
r graden, s minuten, t seconden --> r + s/60 + t/3600
De uiteindelijke xy-coordinaten zijn factor 100.000 van de radiale coordinaten.
De parameter in de aanroep is:
address=434806_520
Entry point: getroute.asp Een routebeschrijving naar de locatie
Gebruik deze ingang zodat een gebruiker direct de routebeschrijving naar de locatie kan verkrijgen. Het adres van getroute.asp is:
http://tools.locatienet.com/location/getroute.asp
Een route kan alleen worden berekend als vertrek- en aankomstadres bekend zijn. Het aankomstadres is natuurlijk al bekend. Het vertrekadres daarentegen is willekeurig. Een gebruiker van de Locatienet™Map&Route vult zijn eigen adresgegevens in en een HTML-pagina toont vervolgens een routebeschrijving vanaf dat adres naar de locatie, een landkaart met het traject en een plattegrond met het laatste gedeelte van de route totaan de locatie.
De pagina toont ook een link waarmee de route kan worden uitgeprint.
Deze directe aanroep naar een route vereist dat het vertrekadres van de bezoeker wordt meegegeven aan. De parameters van de aanroep zijn:
street_start: de naam ( + huisnummer) van de straat van het vertrekadres.
postcode_start: de postcode van het adres van het vertrekpunt.
city_start: de naam van de plaats van het vertrekadres.
country_start: de code van het land van het vertrekadres.
Naast deze parameters zijn er parameters voor het instellen van het voertuig voor de route en de optimalisatie.
De Locatienet™Map&Route kan alleen een route berekenen voor een gemotoriseerd vervoermiddel. Hierbij wordt onderscheid gemaakt tussen een normale personenwagen, een personenwagen met aanhanger of een vrachtwagen.
De parameter is 'speedprofile' en de mogelijke waarden zijn:
1 = personenwagen
2 = auto met aanhanger
3 = vrachtwagen
De optimalisatie is een percentage waarmee de voorkeurroute kan worden ingesteld. Bij een klein percentage (30%) wordt de korste route berekend bij 100% wordt gezocht naar de snelste route. Routenet.nl handeert een waarde van 90% voor de optimale route.
De naam van de parameter waarmee de optimalisatie kan worden ingesteld is 'optfactor'.
De vormgeving
De vormgeving van de Locatienet Map&Route kan worden geconfigureerd met de volgende parameters: markertext: de omschrijving van de locatie wordt weergegeven in de plattegrond onder de marker van de locatie. (Standaard word het adres weergegeven)
css: een url naar een css-bestand waarin de stylerules voor de HTML-tag in de Locatietool zijn gedefinieerd. Hieronder vindt u een link naar het Map&Route style guide document.
background: een url naar een afbeelding dat als achtergrond wordt weergegeven in elke Locatietool pagina.
bgcolor: een (hexidecimale) kleurcode die als achtergrondkleur wordt gebruikt in elke Locatietool pagina.
logo: een url naar een afbeelding die wordt weergeven op elke Locatienet Map&Route pagina.
returnurl: een url die als link wordt weergegeven op elke Map&Route pagina.
returntext: de tekst die wordt gebruikt om de returnurl weer te geven. (Standaard is dit 'Terug'/'Back'/etc)
language: De taal waarin de 'vaste' teksten en in de Map&Route worden weergegeven.
Een bezoeker kan op de plattegrond altijd in- en uitzoomen. De zoom kan van te voren ingesteld met de 'zoom' parameter. De Map&Route gaat uit van de volgende schaalniveau's:
