GeolocationThis services provides methods for geographical information about neighborhoodcodes and postcodes. Summary | This services provides methods for geographical information about neighborhoodcodes and postcodes. | | | | Returns the coordinates in the RD system of the neighborhood, given the neighborhood code. | | Returns the coordinates of the given postcode in the RD system. | | Returns the coordinates in the latitude/longitude system of the neighborhood, given the neighborhood code. | | Returns the coordinates of the given postcode in degrees of latitude/longitude. | | Returns the coordinates of the given address in degrees of latitude/longitude. | | Returns the coordinates of the given address in the RD system. | | Returns the postcode of the address closest to the specified latitude/longitude coordinate in the Netherlands | | Returns the address and geoLocation info closest to the specified latitude/longitude coordinate in the Netherlands | | Returns the postcode of the address closest to the specified Rijksdriehoeksmeting coordinate in the Netherlands | | Returns the address and geoLocation info closest to the specified Rijksdriehoeksmeting X/Y coordinate in the Netherlands. | | | | Returns the coordinates of the given postcode in degrees of latitude/longitude. | | Returns the coordinates of the given address in degrees of latitude/longitude. | | Returns the address and geoLocation info closest to the specified latitude/longitude coordinate. | | | | Returns the estimated distance in meters (in a direct line) between two neighborhoods, given the neighborhood codes. | | Returns the estimated distance in meters (in a direct line) between two postcodes. | | Returns the distance in meters (in a direct line) between two latitude/longitude coordinates. | | | | Returns a given neighborhoodcode list sorted in order of increasing distance from a given neighborhood | | Returns a list of neighborhood codes sorted in order of increasing distance from a given neighborhood, within a given radius (in meters). | | Returns a list of postcodes sorted in order of increasing distance from a given postcode, within a given radius (in meters). | | Returns a given postcode list sorted in order of increasing distance from a given postcode. | | | | Convert a latitude/longitude coordinate to a RD (‘Rijksdriehoeksmeting’) coordinate. | | Convert a RD (‘Rijksdriehoeksmeting’) coordinate to a latitude/longitude coordinate. | | | | | | | | | | | | | | | | | | A geographical location in the RD system (‘Rijksdriehoeksmeting’). | | A geographical location in the RD system (‘Rijksdriehoeksmeting’). | | A geographical location in the latitude/longitude system. | | A geographical location in the latitude/longitude system. | | A geographical location in the latitude/longitude system. | | | | | | | | | | A single postal neighborhoodcode entry. |
geoLocationNeighborhoodCoordinatesRDReturns the coordinates in the RD system of the neighborhood, given the neighborhood code. Parameters| nbcode | Neighborhoodcode to find the location of |
ReturnsgeoLocationPostcodeCoordinatesRDReturns the coordinates of the given postcode in the RD system. Parameters| postcode | Postcode to find the location of |
ReturnsgeoLocationNeighborhoodCoordinatesLatLonReturns the coordinates in the latitude/longitude system of the neighborhood, given the neighborhood code. Parameters| nbcode | Neighborhoodcode to find the location of |
ReturnsgeoLocationPostcodeCoordinatesLatLonReturns the coordinates of the given postcode in degrees of latitude/longitude. Parameters| postcode | Postcode to find the location of |
ReturnsgeoLocationAddressCoordinatesLatLonReturns the coordinates of the given address in degrees of latitude/longitude. You may either specify an address using postcode and house number, or using city, street and house number. Either postcode or city is required. When the city and street parameters are specified the city name and street name that were matched are returned in the result. If a house number is specified its location is interpolated using coordinates of the address range it belongs to. Accuracy may vary depending on the actual distribution of addresses in the range. For the most accurate house number coordinates, use Kadaster::kadasterAddressCoordinates. Parameters| postcode | Address postcode | | city | Address city | | street | Address street | | houseno | Address house number |
ReturnsSee alsoKadaster::kadasterAddressCoordinates, <geoLocationInternationalAddressCoordinatesLatLon> geoLocationAddressCoordinatesRDReturns the coordinates of the given address in the RD system. You may either specify an address using postcode and house number, or using city, street and house number. Either postcode or city is required. When the city and street parameters are specified the city name and street name that were matched are returned in the result. If a house number is specified its location is interpolated using coordinates of the address range it belongs to. Accuracy may vary depending on the actual distribution of addresses in the range. For the most accurate house number coordinates, use Kadaster::kadasterAddressCoordinates. Parameters| postcode | Address postcode | | city | Address city | | street | Address street | | houseno | Address house number |
ReturnsSee alsoKadaster::kadasterAddressCoordinates geoLocationLatLonToPostcodeReturns the postcode of the address closest to the specified latitude/longitude coordinate in the Netherlands Parameters| latitude | Latitude of the postcode | | longitude | Longitude of the postcode |
Returns| postcode | The postcode closest to the coordinates. |
geoLocationLatLonToAddressV2Returns the address and geoLocation info closest to the specified latitude/longitude coordinate in the Netherlands This method differs from geoLocationLatLonToAddress in that it is more preciseit uses data with house number precision, instead of house number range precision. This means that a specific house number is returned instead of a range, and that the returned address is typically closer to the coordinate than with geoLocationLatLonToAddress. Note that this method may return a different street than geoLocationLatLonToAddress. Parameters| latitude | Latitude of the location | | longitude | Longitude of the location |
ReturnsSee alsogeoLocationInternationalLatLonToAddress geoLocationRDToPostcodeReturns the postcode of the address closest to the specified Rijksdriehoeksmeting coordinate in the Netherlands Parameters| x | x part of the RD coordinate | | y | y part of the RD coordinate |
Returns| postcode | The postcode closest to the coordinates. |
geoLocationRDToAddressV2Returns the address and geoLocation info closest to the specified Rijksdriehoeksmeting X/Y coordinate in the Netherlands. This method differs from geoLocationLatLonToAddress in that it is more preciseit uses data with house number precision, instead of house number range precision. This means that a specific house number is returned instead of a range, and that the returned address is typically closer to the coordinate than with geoLocationRDToAddress. Note that this method may return a different street than geoLocationRDToAddress. Parameters| x | rd X of the location | | y | rd Y of the location |
ReturnsInternational location methodsgeoLocationInternationalPostcodeCoordinatesLatLonReturns the coordinates of the given postcode in degrees of latitude/longitude. Most countries are supported by this function. Accuracy of the result may vary between countries. Parameters| postcode | Postcode to find the location of (postcode format varies depending on the country specified) | | country | Country of the address. Country can be specified by using ISO3 country codes (recommended). Complete country names may not always work. |
ReturnsgeoLocationInternationalAddressCoordinatesLatLonV2Returns the coordinates of the given address in degrees of latitude/longitude. Most countries are supported by this function. Accuracy of the result may vary between countries. Parameters: country - Country of the address. Country can be specified by using ISO3 country codes (recommended). Complete country names may not always work. postalcode - Postalcode houseno - House number street - Complete street name. Street name may not be abbreviated, but may be empty. city - Complete city name. City name may not be abbreviated, but may be empty. province - Province, state, district (depends on country, may not be abbreviated). Ignored if not exactly matched. matchrate - The minimum matchlevel the returned search-results range [0-100] language - Language used for input and preferred language for the output. Depending on the amount of available data and the precision of the result, the output might not match the language requested. Returns: coordinates - A LatLonCoordinatesInternationalAddress entry. geoLocationInternationalLatLonToAddressReturns the address and geoLocation info closest to the specified latitude/longitude coordinate. Parameters| latitude | Latitude of the location | | longitude | Longitude of the location |
ReturnsgeoLocationNeighborhoodDistanceReturns the estimated distance in meters (in a direct line) between two neighborhoods, given the neighborhood codes. Parameters| nbcodefrom | Neighborhoodcode of the first neighborhood | | nbcodeto | Neighborhoodcode of the second neighborhood |
Returns| distance | The distance in meters. |
See alsoDriveinfo::driveInfoDistanceLookup geoLocationPostcodeDistanceReturns the estimated distance in meters (in a direct line) between two postcodes. Parameters| postcodefrom | First postcode | | postcodeto | Second postcode |
ReturnsgeoLocationHaversineDistanceReturns the distance in meters (in a direct line) between two latitude/longitude coordinates. Computed by using the Haversine formula, which is accurate as long as the locations are not antipodal (at the other side of the Earth). Parameters| latitude_coord_1 | Latitude of the first location | | longitude_coord_1 | Longitude of the first location | | latitude_coord_2 | Latitude of the second location | | longitude_coord_2 | Longitude of the second location | | in_radians | Indicate if input is in radians (otherwise they are interpreted as degrees) |
Returns| distance | The distance in meters. |
geoLocationDistanceSortedNeighborhoodCodesReturns a given neighborhoodcode list sorted in order of increasing distance from a given neighborhood Parameters| nbcodefrom | Neighborhoodcode to sort the list on | | nbcodes | Array of neighborhood codes to sort using increasing distance to nbcodefrom. Returns: | | nbcodes | A Patterns::{Type}Array of SortedPostcode entries. |
geoLocationDistanceSortedNeighborhoodCodesRadiusReturns a list of neighborhood codes sorted in order of increasing distance from a given neighborhood, within a given radius (in meters). Parameters| nbcodefrom | Neighborhoodcode at the center of the radius | | radius | Radius from nbcodefrom to search in, in meters | | page | Page to retrieve, pages start counting at 1 |
ReturnsgeoLocationDistanceSortedPostcodesRadiusReturns a list of postcodes sorted in order of increasing distance from a given postcode, within a given radius (in meters). If the radius is larger than 1500 meters, the result will be based on neighborhood codes. Parameters| postcodefrom | Postcode at the center of the radius | | radius | Radius from postcodefrom to search in, in meters | | page | Page to retrieve, pages start counting at 1 |
ReturnsgeoLocationDistanceSortedPostcodesReturns a given postcode list sorted in order of increasing distance from a given postcode. Parameters| postcodefrom | Postcode to sort the list on | | postcodes | Array of postcodes to sort using increasing distance to postcodefrom. |
ReturnsCoordinate conversion methodsgeoLocationLatLonToRDConvert a latitude/longitude coordinate to a RD (‘Rijksdriehoeksmeting’) coordinate. Parameters: latitude - Latitude longitude - Longitude ReturnsgeoLocationRDToLatLonConvert a RD (‘Rijksdriehoeksmeting’) coordinate to a latitude/longitude coordinate. Parameters: x - x part of the RD coordinate y - y part of the RD coordinate ReturnsDeprecated service methodsgeoLocationLatLonToAddressNoticeThis method is deprecated, use geoLocationLatLonToAddressV2 instead Returns the address and geoLocation info closest to the specified latitude/longitude coordinate in the Netherlands Parameters| latitude | Latitude of the location | | longitude | Longitude of the location |
ReturnsgeoLocationRDToAddressNoticeThis method is deprecated, use geoLocationRDToAddressV2 instead Returns the address and geoLocation info closest to the specified Rijksdriehoeksmeting X/Y coordinate in the Netherlands Parameters| x | rd X of the location | | y | rd Y of the location |
ReturnsgeoCoordinatesRDNoticeThis method is deprecated, use geoLocationNeighborhoodCoordinatesRD instead Returns the coordinates in the RD system of the neighborhood, given the neighborhood code. Parameters| nbcode | Neighborhoodcode to find the location of |
Returnsgeo6PPCoordinatesRDNoticeThis method is deprecated, use geoLocationPostcodeCoordinatesRD instead Returns the coordinates in the RD system of the given postcode Parameters| postcode | Postcode to find the location of |
ReturnsgeoCoordinatesLatLonNoticeThis method is deprecated, use geoLocationNeighborhoodCoordinatesLatLon instead Returns the coordinates in the latitude/longitude system of the neighborhood, given the neighborhood code. Parameters| nbcode | Neighborhoodcode to find the location of |
Returnsgeo6PPDistanceNoticeThis method is deprecated, use geoLocationPostcodeDistance instead Returns the estimated distance in meters (in a direct line) between two postcodes. Parameters| postcodefrom | First postcode | | postcodeto | Second postcode |
Returns| distance | The distance in meters. |
RDCoordinatesA geographical location in the RD system (‘Rijksdriehoeksmeting’). x - The x coordinate y - The y coordinate RDCoordinatesMatchA geographical location in the RD system (‘Rijksdriehoeksmeting’). Includes the city+street that was matched on. | x | The x coordinate | | y | The y coordinate | | citymatch | Name of the city that was matched | | streetmatch | Name of the street that was matched |
LatLonCoordinatesA geographical location in the latitude/longitude system. | latitude | The latitude in degrees (floating point) | | longitude | The degrees in degrees (floating point) |
LatLonCoordinatesMatchA geographical location in the latitude/longitude system. Includes the city+street that was matched on. | latitude | The latitude in degrees (floating point) | | longitude | The degrees in degrees (floating point) | | citymatch | Name of the city that was matched | | streetmatch | Name of the street that was matched |
LatLonCoordinatesInternationalAddressA geographical location in the latitude/longitude system. Includes some address information (if available). | postcode | Postcode, format depends on country | | street | Street name, possibly including housenumber | | city | City name | | province | Province, state, district (depends on country) | | country_iso2 | Country name, ISO 2 abbreviation | | latitude | latitude of the address | | longitude | longitude of the address |
GeoLocationAddressAddress information. Only features a subset of similar complexType PCreeks. | houseno_from | Lowest house number of a postcode range. domain : 0-99999 | | houseno_to | Highest house number of a postcode range. domain : 0-99999 | | postcode | Complete dutch postcode | | streetname | Street name | | city | City name | | district | Dutch ‘gemeente’ name | | province | Dutch ‘provincie’ name | | distance | Distance in meters between requested location and found address | | x | rd x coordinate of the address | | y | rd y coordinate of the address | | latitude | latitude of the address | | longitude | longitude of the address |
GeoLocationAddressV2Address information. Only features a subset of similar complexType PCreeks. Differs from GeoLocationAddress by specifying an exact house number, instead of a range. | house_no | House number. domain : 0-99999 | | house_no_addition | House number addition | | postcode | Complete dutch postcode | | streetname | Street name | | city | City name | | district | Dutch ‘gemeente’ name | | province | Dutch ‘provincie’ name | | distance | Distance in meters between requested location and found address | | x | rd x coordinate of the address | | y | rd y coordinate of the address | | latitude | latitude of the address | | longitude | longitude of the address |
GeoLocationInternationalAddressAddress information. | postcode | Postcode, format depends on country | | streetname | Street name, possibly including house number | | city | City name | | province | Province, state, district (depends on country) | | country | Country name (English) | | country_iso3 | Country name, ISO 3 abbreviation | | distance | Distance in meters between requested location and found address | | latitude | latitude of the address | | longitude | longitude of the address |
SortedPostcodeA sorted postcode entry. | postcode | The postcode related to the entry | | distance | Distance in meters to the reference point | | precision | What kind of presision was used to determine the location: ‘neighborhood’ = the neighborhoodcode was used, ‘postcode’ = the postcode was used, ‘none’ = no location could be found. |
NeighborhoodA single postal neighborhoodcode entry. | nbcode | postal neighborhoodcode |
|