geolocatesvc
Click here for a complete list of operations.
Georef3
Georeferences a locality description. returns a 'Georef_Result_Set' given vLocality, vGeorgraphy and boolean georeferencing options. VLocality and VGeogrpahy are fields specific to BioGeomancer.
Language key refers to an integer representing different languages libraries. Will default to basic english (0) if invalid key is provided
*North American Localities Only*
Test
To test the operation using the HTTP POST protocol, click the 'Invoke' button.SOAP 1.1
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
POST /webservices/geolocatesvcv2/geolocatesvc.asmx HTTP/1.1 Host: www.geo-locate.org Content-Type: text/xml; charset=utf-8 Content-Length: length SOAPAction: "http://geo-locate.org/webservices/Georef3" <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <Georef3 xmlns="http://geo-locate.org/webservices/"> <vLocality>string</vLocality> <vGeography>string</vGeography> <HwyX>boolean</HwyX> <FindWaterbody>boolean</FindWaterbody> <RestrictToLowestAdm>boolean</RestrictToLowestAdm> <doUncert>boolean</doUncert> <doPoly>boolean</doPoly> <displacePoly>boolean</displacePoly> <polyAsLinkID>boolean</polyAsLinkID> <LanguageKey>int</LanguageKey> </Georef3> </soap:Body> </soap:Envelope>
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/"> <soap:Body> <Georef3Response xmlns="http://geo-locate.org/webservices/"> <Result> <EngineVersion>string</EngineVersion> <NumResults>int</NumResults> <ExecutionTimems>double</ExecutionTimems> <ResultSet> <WGS84Coordinate> <Latitude>double</Latitude> <Longitude>double</Longitude> </WGS84Coordinate> <ParsePattern>string</ParsePattern> <Precision>string</Precision> <Score>int</Score> <UncertaintyRadiusMeters>string</UncertaintyRadiusMeters> <UncertaintyPolygon>string</UncertaintyPolygon> <ReferenceLocation>string</ReferenceLocation> <DisplacedDistanceMiles>double</DisplacedDistanceMiles> <DisplacedHeadingDegrees>double</DisplacedHeadingDegrees> <Debug>string</Debug> </ResultSet> <ResultSet> <WGS84Coordinate> <Latitude>double</Latitude> <Longitude>double</Longitude> </WGS84Coordinate> <ParsePattern>string</ParsePattern> <Precision>string</Precision> <Score>int</Score> <UncertaintyRadiusMeters>string</UncertaintyRadiusMeters> <UncertaintyPolygon>string</UncertaintyPolygon> <ReferenceLocation>string</ReferenceLocation> <DisplacedDistanceMiles>double</DisplacedDistanceMiles> <DisplacedHeadingDegrees>double</DisplacedHeadingDegrees> <Debug>string</Debug> </ResultSet> </Result> </Georef3Response> </soap:Body> </soap:Envelope>
SOAP 1.2
The following is a sample SOAP 1.2 request and response. The placeholders shown need to be replaced with actual values.
POST /webservices/geolocatesvcv2/geolocatesvc.asmx HTTP/1.1 Host: www.geo-locate.org Content-Type: application/soap+xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"> <soap12:Body> <Georef3 xmlns="http://geo-locate.org/webservices/"> <vLocality>string</vLocality> <vGeography>string</vGeography> <HwyX>boolean</HwyX> <FindWaterbody>boolean</FindWaterbody> <RestrictToLowestAdm>boolean</RestrictToLowestAdm> <doUncert>boolean</doUncert> <doPoly>boolean</doPoly> <displacePoly>boolean</displacePoly> <polyAsLinkID>boolean</polyAsLinkID> <LanguageKey>int</LanguageKey> </Georef3> </soap12:Body> </soap12:Envelope>
HTTP/1.1 200 OK Content-Type: application/soap+xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <soap12:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap12="http://www.w3.org/2003/05/soap-envelope"> <soap12:Body> <Georef3Response xmlns="http://geo-locate.org/webservices/"> <Result> <EngineVersion>string</EngineVersion> <NumResults>int</NumResults> <ExecutionTimems>double</ExecutionTimems> <ResultSet> <WGS84Coordinate> <Latitude>double</Latitude> <Longitude>double</Longitude> </WGS84Coordinate> <ParsePattern>string</ParsePattern> <Precision>string</Precision> <Score>int</Score> <UncertaintyRadiusMeters>string</UncertaintyRadiusMeters> <UncertaintyPolygon>string</UncertaintyPolygon> <ReferenceLocation>string</ReferenceLocation> <DisplacedDistanceMiles>double</DisplacedDistanceMiles> <DisplacedHeadingDegrees>double</DisplacedHeadingDegrees> <Debug>string</Debug> </ResultSet> <ResultSet> <WGS84Coordinate> <Latitude>double</Latitude> <Longitude>double</Longitude> </WGS84Coordinate> <ParsePattern>string</ParsePattern> <Precision>string</Precision> <Score>int</Score> <UncertaintyRadiusMeters>string</UncertaintyRadiusMeters> <UncertaintyPolygon>string</UncertaintyPolygon> <ReferenceLocation>string</ReferenceLocation> <DisplacedDistanceMiles>double</DisplacedDistanceMiles> <DisplacedHeadingDegrees>double</DisplacedHeadingDegrees> <Debug>string</Debug> </ResultSet> </Result> </Georef3Response> </soap12:Body> </soap12:Envelope>
HTTP GET
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
GET /webservices/geolocatesvcv2/geolocatesvc.asmx/Georef3?vLocality=string&vGeography=string&HwyX=string&FindWaterbody=string&RestrictToLowestAdm=string&doUncert=string&doPoly=string&displacePoly=string&polyAsLinkID=string&LanguageKey=string HTTP/1.1 Host: www.geo-locate.org
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <Georef_Result_Set xmlns="http://geo-locate.org/webservices/"> <EngineVersion>string</EngineVersion> <NumResults>int</NumResults> <ExecutionTimems>double</ExecutionTimems> <ResultSet> <WGS84Coordinate> <Latitude>double</Latitude> <Longitude>double</Longitude> </WGS84Coordinate> <ParsePattern>string</ParsePattern> <Precision>string</Precision> <Score>int</Score> <UncertaintyRadiusMeters>string</UncertaintyRadiusMeters> <UncertaintyPolygon>string</UncertaintyPolygon> <ReferenceLocation>string</ReferenceLocation> <DisplacedDistanceMiles>double</DisplacedDistanceMiles> <DisplacedHeadingDegrees>double</DisplacedHeadingDegrees> <Debug>string</Debug> </ResultSet> <ResultSet> <WGS84Coordinate> <Latitude>double</Latitude> <Longitude>double</Longitude> </WGS84Coordinate> <ParsePattern>string</ParsePattern> <Precision>string</Precision> <Score>int</Score> <UncertaintyRadiusMeters>string</UncertaintyRadiusMeters> <UncertaintyPolygon>string</UncertaintyPolygon> <ReferenceLocation>string</ReferenceLocation> <DisplacedDistanceMiles>double</DisplacedDistanceMiles> <DisplacedHeadingDegrees>double</DisplacedHeadingDegrees> <Debug>string</Debug> </ResultSet> </Georef_Result_Set>
HTTP POST
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
POST /webservices/geolocatesvcv2/geolocatesvc.asmx/Georef3 HTTP/1.1 Host: www.geo-locate.org Content-Type: application/x-www-form-urlencoded Content-Length: length vLocality=string&vGeography=string&HwyX=string&FindWaterbody=string&RestrictToLowestAdm=string&doUncert=string&doPoly=string&displacePoly=string&polyAsLinkID=string&LanguageKey=string
HTTP/1.1 200 OK Content-Type: text/xml; charset=utf-8 Content-Length: length <?xml version="1.0" encoding="utf-8"?> <Georef_Result_Set xmlns="http://geo-locate.org/webservices/"> <EngineVersion>string</EngineVersion> <NumResults>int</NumResults> <ExecutionTimems>double</ExecutionTimems> <ResultSet> <WGS84Coordinate> <Latitude>double</Latitude> <Longitude>double</Longitude> </WGS84Coordinate> <ParsePattern>string</ParsePattern> <Precision>string</Precision> <Score>int</Score> <UncertaintyRadiusMeters>string</UncertaintyRadiusMeters> <UncertaintyPolygon>string</UncertaintyPolygon> <ReferenceLocation>string</ReferenceLocation> <DisplacedDistanceMiles>double</DisplacedDistanceMiles> <DisplacedHeadingDegrees>double</DisplacedHeadingDegrees> <Debug>string</Debug> </ResultSet> <ResultSet> <WGS84Coordinate> <Latitude>double</Latitude> <Longitude>double</Longitude> </WGS84Coordinate> <ParsePattern>string</ParsePattern> <Precision>string</Precision> <Score>int</Score> <UncertaintyRadiusMeters>string</UncertaintyRadiusMeters> <UncertaintyPolygon>string</UncertaintyPolygon> <ReferenceLocation>string</ReferenceLocation> <DisplacedDistanceMiles>double</DisplacedDistanceMiles> <DisplacedHeadingDegrees>double</DisplacedHeadingDegrees> <Debug>string</Debug> </ResultSet> </Georef_Result_Set>