Stel je voor dat je op zoek bent naar nuttige locaties binnen een specifiek postcodegebied. Of je wilt weten welke eenheden er bij een bepaald adres horen voor postbezorging. In de ArcGIS Geocoding service is recent een parameter toegevoegd om deze locaties eenvoudig te vinden: de searchWithin. De parameter is speciaal gemaakt voor het zoeken naar adressen in Nederland en Groot-Brittannië, naar aanleiding van wensen voor deze functionaliteit. In dit blog wordt uitgelegd hoe deze nieuwe parameter werkt en wat voor toepassingen het kent.
De searchWithin is een parameter die gebruikt kan worden binnen de findAddressCandidates-functie. Hiermee is het mogelijk een verzameling aan locaties terug te krijgen die bij een bepaald adreslocatie-verzoek horen. De searchWithin-parameter wordt samen met de parameters start en num gebruik. Hiermee kun je aangeven op welk punt de resultaten moeten beginnen en hoeveel resultaten je per pagina wilt zien. Dit geeft je meer controle over hoe de informatie wordt weergegeven en maakt het gemakkelijker om door de resultaten te navigeren. Hieronder zijn twee voorbeelden te vinden hoe deze functionaliteit kan worden toegepast.
Nuttige locaties binnen een postcode
Of het nu gaat om restaurants, winkels of andere interessante plekken, de searchWihtin-parameter helpt je bij het ontdekken van wat een bepaalde postcode te bieden heeft. Om een lijst te genereren met e-mailadressen van POI’s in het postcodegebied van Amsterdam Centraal voer ik het volgende verzoek uit:
Wat is er terug te zien in dit verzoek?
- outFields: de verschillende attributen die je zou willen opvragen, zoals het type POI, de naam van de locatie, het adres en de URL van een eventuele website. Als je hier * invult krijg je alle outputattributen terug.
- searchWithin: het is mogelijk te zoeken naar POI’s, adressen en subadressen. In dit geval wil ik zoeken naar POI’s.
- num: het aantal resultaten dat je terug wilt krijgen in de zoekopdracht. Het maximum is 50, dus dat pas ik hier toe.
- start: het startnummer van de resultaten die je terug wilt krijgen. Standaard is dit 1, maar ik begin hier op 2 om de postcode als resultaat zelf over te slaan. Als er meer dan 50 resultaten zijn kan je voor meer resultaten starten op 51.
- singleLine: de zoekopdracht waarbinnen je wilt zoeken, in dit geval de postcode waarbinnen Amsterdam Centraal valt.
Als resultaat krijg je nu alle POI’s terug binnen het postcodegebied van Amsterdam Centraal. Ook zijn er andere gegevens meegegeven, zoals de naam en de website van de locatie, als deze aanwezig zijn.
Adressen binnen een appartementencomplex
Bij het aanschrijven van verschillende adressen binnen een appartementencomplex kan het handig zijn te weten hoeveel eenheden er bij een bepaald adres horen. Met de searchWithin-parameter is dit snel op te vragen. Je maakt hierbij gebruik van het volgende verzoek:
Wat is er terug te zien in dit verzoek?
- outFields: in dit geval is gekozen voor het adres en het de naam van de eenheid. De eenheid is in dit geval de huisnummertoevoeging.
- searchWithin: dit keer wordt er gezocht naar subadressen.
- num en start: hetzeldfe als eerdere voorbeeld voor het maximale aantal resultaten.
- singleLine: de postcode waarbinnen ik wil zoeken.
Als resultaat krijg je nu alle subadressen die binnen het postcodegebied vallen terug. Er is te zien dat de verschillende adressen meerdere eenheden hebben.
Token genereren voor gebruik
Vergeet niet dat voor het gebruik van deze service een geldige token nodig is met de juiste geocodeermachtigingen. Zorg ervoor dat je de stappen volgt om een token te genereren en deze toe te voegen aan je verzoeken. Dit is essentieel om toegang te krijgen tot de geolocatiegegevens en de functionaliteiten van de API te benutten. Een token genereren kan met behulp van bijvoorbeeld een API key authentication.
In dit blog zijn praktische toepassingen beschreven voor het vinden van locaties binnen een bepaalde postcode of adres. Door de mogelijkheden die deze service biedt verder te verkennen, kun je waardevolle inzichten verkrijgen bij het werken met adressen. Meer informatie over het gebruik van deze parameters is ook te vinden in de Productinformatie over de ArcGIS World Geocoder en Developer-documentatie.
