API documentatie
De Verdwenen Gebouwen API biedt een aantal zoekmogelijkheden - naam, type, plaats of boundingbox. De resultaten kunnen als JSON of GEOJSON geleverd worden.
/search/
| parameter | format | description |
|---|---|---|
| q | urlencoded string | Searches in names, alternative names, description and placenames. Only strings at least 4 characters long will be searched for: Berenstraat 27 will produce the same results as Berenstraat. Quotes may be used to search for a phrase with spaces, as in "Berenstraat 27" |
| name | urlencoded string | Searches in names and alternative names. See remarks with q. |
| place | urlencoded string | Searches in placenames. See remarks with q. |
| withImgs | boolean | Returns array of depictions within each record, if any. Defaults to false. Do not use in combination with from and limit |
| boxTopLeft | lat,lon | The top-left of the boundingbox from within you want results. Always use together with boxBottomRight |
| boxBottomRight | lat,lon | The bottom-right of the boundingbox from within you want results. Always use together with boxTopLeft |
| type | uri | Use Getty AAT URI's to get buildings of a specific type - use http://vocab.getty.edu/aat/300007117 to get theaters. Click a type in the list of types to find the corresponding URI in the URL. |
| from | int | Gives results from from on. |
| limit | int | Maximum number of results, defaults to 500. Use in combination with from to loop through results. |
| format | json or geojson | Default format is json |
http://verdwenengebouwen.nl/api/search/?name=Utrecht
http://verdwenengebouwen.nl/api/search/?name=Berenstraat%2027
http://verdwenengebouwen.nl/api/search/?name="Berenstraat%2027"
http://verdwenengebouwen.nl/api/search/?place=Amsterdam&from=100&limit=100
http://verdwenengebouwen.nl/api/search/?boxTopLeft=52.397571,4.617176&boxBottomRight=52.380704,4.652710
http://verdwenengebouwen.nl/api/search/?type=http://vocab.getty.edu/aat/300007117
http://verdwenengebouwen.nl/api/search/?place=alkmaar&withImgs=true
http://verdwenengebouwen.nl/api/search/?place=alkmaar&withImgs=true&format=geojson
/gebouw/json/{id}
Elk verdwenenen gebouw heeft niet alleen een eigen pagina, maar ook een json-representatie van de data betreffende dat gebouw.
http://verdwenengebouwen.nl/gebouw/json/3569/theme/
Het is mogelijk themadossiers op te vragen en je kan ook een eigen custom thema samenstellen.
| parameter | format | description |
|---|---|---|
| theme | int | Use the id of a 'themadossier' to get the buildings that are in the theme. |
| buildings | comma separated integers | Get a list of buildings by giving their id's. |
| format | json or geojson | Default format is geojson |
http://verdwenengebouwen.nl/api/theme/?theme=1&format=json
http://verdwenengebouwen.nl/api/theme/?buildings=5303,3750,3428,3764,3791,836
/images/
In sommige gevallen zou het handig zijn om alle afbeeldingen van één collectie op te kunnen vragen. Bijvoorbeeld als een collectiebeheerder in het eigen systeem Verdwenen Gebouwen identifiers en/of geometrieën op wil nemen.
| parameter | format | description |
|---|---|---|
| domain | urlencoded string | Searches for images where domain is part of the permalink |
| from | int | Gives results from from on. |
| limit | int | Maximum number of results, defaults to 500. Use in combination with from to loop through results. |
http://verdwenengebouwen.nl/api/images/?domain=http://hdl.handle.net/11259/
http://verdwenengebouwen.nl/api/images/?domain=amsterdam.nl&from=10&limit=20
