Online Search

Online Search offers a versatile marine entity search thay allows searching for specific entities such as lakes, harbours and cities. The geometry of the items found can be included in the output.

All coordinates are in WGS84.

API

<base-url>/api/search/<version>/search.json?<parameters>

Parameters

parameter description values default value
version API version 1
point WGS84 latitude,longitude latitude=-90..90 longitude=-180..180 52.100556,5.645833
radius search radius in meters 100..500,000 m 50,000 m
query the search query (use * for wildcards)
types comma separated list of entity types to search for CITY,LAKE,MUNICIPALITY,PARK,INDUSTRIAL,CANAL
 max maximum number of results 1..100 10
resolve entities to be included one of none,boundingbox,shape none
fuzzyLevel hint on how to search (fuzzy does a phonetic search) 0=exact match, 1=fuzzy 0
language map label language en,nl,fy,de en
API-key API secret key, to be requested from MarinePlan

Response

The response contains:

  • a copy of the input parameters
  • a list of result locations with their reverse geo-coded output
{
	"parameters": {
		"point": {
			"latitude": 52.413285,
			"longitude": 4.864067
		},
		"radiusMeters": 200000.0,
		"query": "swol*",
		"maxResults": 100,
		"types": [],
		"language": "nl",
		"resolveLevels": ["PLACE"],
		"fuzzyLevel": 1
	},
	"results": [{
		"location": {
			"type": "BRIDGE",
			"point": {
				"latitude": 52.657537,
				"longitude": 5.632158
			},
			"placement": "ALONG",
			"distanceMeters": 58578.0,
			"name": "Zwolsebrug"
		},
		"place": {
			"parameters": {
				"point": {
					"latitude": 52.657537,
					"longitude": 5.632158
				},
				"language": "nl",
				"locationTypes": ["CITY", "LAKE", "MUNICIPALITY", "PARK"],
				"strict": true
			},
			"country": "Nederland",
			"province": "Flevoland",
			"municipality": "Urk",
			"city": "",
			"countryCodeIso2": "nl",
			"mapcode": {
				"territory": "NLD",
				"mapcode": "8PK.92X",
				"internationalMapcode": "WJ090.HG6J"
			},
			"locations": [],
			"description": "Urk, Flevoland"
		}
	}, {
		"location": {
			"type": "CANAL",
			"point": {
				"latitude": 52.706858,
				"longitude": 5.756298
			},
			"placement": "ALONG",
			"distanceMeters": 68529.0,
			"name": "Zwolse Vaart"
		},
		"place": {
			"parameters": {
				"point": {
					"latitude": 52.706858,
					"longitude": 5.756298
				},
				"language": "nl",
				"locationTypes": ["CITY", "LAKE", "MUNICIPALITY", "PARK"],
				"strict": true
			},
			"country": "Nederland",
			"province": "Flevoland",
			"municipality": "Noordoostpolder",
			"city": "Emmeloord",
			"countryCodeIso2": "nl",
			"mapcode": {
				"territory": "NLD",
				"mapcode": "8WF.MHB",
				"internationalMapcode": "WJ08W.D7B6"
			},
			"locations": [],
			"description": "Emmeloord (Noordoostpolder), Flevoland"
		}
	}, {
		"location": {
			"type": "CANAL",
			"point": {
				"latitude": 52.708424,
				"longitude": 5.811443
			},
			"placement": "ALONG",
			"distanceMeters": 71905.0,
			"name": "Zwolse Vaart"
		},
		"place": {
			"parameters": {
				"point": {
					"latitude": 52.708424,
					"longitude": 5.811443
				},
				"language": "nl",
				"locationTypes": ["CITY", "LAKE", "MUNICIPALITY", "PARK"],
				"strict": true
			},
			"country": "Nederland",
			"province": "Flevoland",
			"municipality": "Noordoostpolder",
			"city": "",
			"countryCodeIso2": "nl",
			"mapcode": {
				"territory": "NLD",
				"mapcode": "8YF.QQC",
				"internationalMapcode": "WJ08X.75LZ"
			},
			"locations": [],
			"description": "Noordoostpolder, Flevoland"
		}
	}, {
		"location": {
			"type": "CANAL",
			"point": {
				"latitude": 52.688766,
				"longitude": 5.882193
			},
			"placement": "ALONG",
			"distanceMeters": 75289.0,
			"name": "Zwolse Vaart"
		},
		"place": {
			"parameters": {
				"point": {
					"latitude": 52.688766,
					"longitude": 5.882193
				},
				"language": "nl",
				"locationTypes": ["CITY", "LAKE", "MUNICIPALITY", "PARK"],
				"strict": true
			},
			"country": "Nederland",
			"province": "Flevoland",
			"municipality": "Noordoostpolder",
			"city": "",
			"countryCodeIso2": "nl",
			"mapcode": {
				"territory": "NLD",
				"mapcode": "92H.095",
				"internationalMapcode": "WJ08Y.BP92"
			},
			"locations": [],
			"description": "Noordoostpolder, Flevoland"
		}
	}, {
		"location": {
			"type": "CANAL",
			"point": {
				"latitude": 52.505755,
				"longitude": 6.048945
			},
			"placement": "ALONG",
			"distanceMeters": 80874.0,
			"name": "Zwolle-IJsselkanaal"
		},
		"place": {
			"parameters": {
				"point": {
					"latitude": 52.505755,
					"longitude": 6.048945
				},
				"language": "nl",
				"locationTypes": ["CITY", "LAKE", "MUNICIPALITY", "PARK"],
				"strict": true
			},
			"country": "Nederland",
			"province": "Overijssel",
			"municipality": "Zwolle",
			"city": "",
			"countryCodeIso2": "nl",
			"mapcode": {
				"territory": "NLD",
				"mapcode": "R6G.JC",
				"internationalMapcode": "VJ06Q.S8PX"
			},
			"locations": [],
			"description": "Zwolle, Overijssel"
		}
	}, {
		"location": {
			"type": "CANAL",
			"point": {
				"latitude": 52.510063,
				"longitude": 6.05492
			},
			"placement": "ALONG",
			"distanceMeters": 81334.0,
			"name": "Zwolle-IJsselkanaal"
		},
		"place": {
			"parameters": {
				"point": {
					"latitude": 52.510063,
					"longitude": 6.05492
				},
				"language": "nl",
				"locationTypes": ["CITY", "LAKE", "MUNICIPALITY", "PARK"],
				"strict": true
			},
			"country": "Nederland",
			"province": "Overijssel",
			"municipality": "Zwolle",
			"city": "",
			"countryCodeIso2": "nl",
			"mapcode": {
				"territory": "NLD",
				"mapcode": "R7D.TV",
				"internationalMapcode": "VJ06Q.W5VM"
			},
			"locations": [],
			"description": "Zwolle, Overijssel"
		}
	}, {
		"location": {
			"type": "LAKE",
			"point": {
				"latitude": 52.638428,
				"longitude": 6.012323
			},
			"placement": "ALONG",
			"distanceMeters": 81554.0,
			"name": "Zwolse Diep"
		},
		"place": {
			"parameters": {
				"point": {
					"latitude": 52.638428,
					"longitude": 6.012323
				},
				"language": "nl",
				"locationTypes": ["CITY", "LAKE", "MUNICIPALITY", "PARK"],
				"strict": true
			},
			"country": "Nederland",
			"province": "Overijssel",
			"municipality": "Zwartewaterland",
			"city": "",
			"countryCodeIso2": "nl",
			"mapcode": {
				"territory": "NLD",
				"mapcode": "98L.LBH",
				"internationalMapcode": "WJ1BB.BY76"
			},
			"locations": [{
				"type": "LAKE",
				"point": {
					"latitude": 52.638213,
					"longitude": 6.015516
				},
				"placement": "IN",
				"distanceMeters": 0.0,
				"name": "Zwolse Diep"
			}],
			"description": "Zwolse Diep, Zwartewaterland, Overijssel"
		}
	}, {
		"location": {
			"type": "CANAL",
			"point": {
				"latitude": 52.516896,
				"longitude": 6.063018
			},
			"placement": "ALONG",
			"distanceMeters": 81974.0,
			"name": "Zwolle-IJsselkanaal"
		},
		"place": {
			"parameters": {
				"point": {
					"latitude": 52.516896,
					"longitude": 6.063018
				},
				"language": "nl",
				"locationTypes": ["CITY", "LAKE", "MUNICIPALITY", "PARK"],
				"strict": true
			},
			"country": "Nederland",
			"province": "Overijssel",
			"municipality": "Zwolle",
			"city": "",
			"countryCodeIso2": "nl",
			"mapcode": {
				"territory": "NLD",
				"mapcode": "R9B.LD",
				"internationalMapcode": "VJ06K.1ZMX"
			},
			"locations": [],
			"description": "Zwolle, Overijssel"
		}
	}, {
		"location": {
			"type": "BRIDGE",
			"point": {
				"latitude": 52.520847,
				"longitude": 6.06905
			},
			"placement": "ALONG",
			"distanceMeters": 82437.0,
			"name": "Zwolle, voetbrug"
		},
		"place": {
			"parameters": {
				"point": {
					"latitude": 52.520847,
					"longitude": 6.06905
				},
				"language": "nl",
				"locationTypes": ["CITY", "LAKE", "MUNICIPALITY", "PARK"],
				"strict": true
			},
			"country": "Nederland",
			"province": "Overijssel",
			"municipality": "Zwolle",
			"city": "",
			"countryCodeIso2": "nl",
			"mapcode": {
				"territory": "NLD",
				"mapcode": "RB8.XZ",
				"internationalMapcode": "VJ06K.4WTW"
			},
			"locations": [],
			"description": "Zwolle, Overijssel"
		}
	}, {
		"location": {
			"type": "HARBOUR",
			"point": {
				"latitude": 52.528363,
				"longitude": 6.072189
			},
			"placement": "ALONG",
			"distanceMeters": 82765.0,
			"name": "Zwols Watersportcenrum"
		},
		"place": {
			"parameters": {
				"point": {
					"latitude": 52.528363,
					"longitude": 6.072189
				},
				"language": "nl",
				"locationTypes": ["CITY", "LAKE", "MUNICIPALITY", "PARK"],
				"strict": true
			},
			"country": "Nederland",
			"province": "Overijssel",
			"municipality": "Zwolle",
			"city": "Zwolle",
			"countryCodeIso2": "nl",
			"mapcode": {
				"territory": "NLD",
				"mapcode": "RC6.L8",
				"internationalMapcode": "VJ06K.6QH3"
			},
			"locations": [],
			"description": "Zwolle, Overijssel"
		}
	}, {
		"location": {
			"type": "HARBOUR",
			"point": {
				"latitude": 52.529459,
				"longitude": 6.072716
			},
			"placement": "ALONG",
			"distanceMeters": 82819.0,
			"name": "Zwols Watersportcenrum"
		},
		"place": {
			"parameters": {
				"point": {
					"latitude": 52.529459,
					"longitude": 6.072716
				},
				"language": "nl",
				"locationTypes": ["CITY", "LAKE", "MUNICIPALITY", "PARK"],
				"strict": true
			},
			"country": "Nederland",
			"province": "Overijssel",
			"municipality": "Zwolle",
			"city": "Zwolle",
			"countryCodeIso2": "nl",
			"mapcode": {
				"territory": "NLD",
				"mapcode": "RC5.QW",
				"internationalMapcode": "VJ06K.6PR8"
			},
			"locations": [],
			"description": "Zwolle, Overijssel"
		}
	}, {
		"location": {
			"type": "CITY",
			"point": {
				"latitude": 52.509649,
				"longitude": 6.105309
			},
			"placement": "ALONG",
			"distanceMeters": 84711.0,
			"name": "Zwolle"
		},
		"place": {
			"parameters": {
				"point": {
					"latitude": 52.509649,
					"longitude": 6.105309
				},
				"language": "nl",
				"locationTypes": ["CITY", "LAKE", "MUNICIPALITY", "PARK"],
				"strict": true
			},
			"country": "Nederland",
			"province": "Overijssel",
			"municipality": "Zwolle",
			"city": "Zwolle",
			"countryCodeIso2": "nl",
			"mapcode": {
				"territory": "NLD",
				"mapcode": "RLD.VZ",
				"internationalMapcode": "VJ06R.S50Y"
			},
			"locations": [],
			"description": "Zwolle, Overijssel"
		}
	}, {
		"location": {
			"type": "MUNICIPALITY",
			"point": {
				"latitude": 52.51423,
				"longitude": 6.107215
			},
			"placement": "ALONG",
			"distanceMeters": 84900.0,
			"name": "Zwolle"
		},
		"place": {
			"parameters": {
				"point": {
					"latitude": 52.51423,
					"longitude": 6.107215
				},
				"language": "nl",
				"locationTypes": ["CITY", "LAKE", "MUNICIPALITY", "PARK"],
				"strict": true
			},
			"country": "Nederland",
			"province": "Overijssel",
			"municipality": "Zwolle",
			"city": "Zwolle",
			"countryCodeIso2": "nl",
			"mapcode": {
				"territory": "NLD",
				"mapcode": "RMC.8B",
				"internationalMapcode": "VJ06R.T20F"
			},
			"locations": [],
			"description": "Zwolle, Overijssel"
		}
	}]
}
Bitnami