Welcome to the Harris Geospatial product documentation center. Here you will find reference guides, help documents, and product libraries.


  >  Docs Center  >  IDL Reference  >  I/O - Network  >  IDLnetOGCWCS::ParseUrl

IDLnetOGCWCS::ParseUrl

IDLnetOGCWCS::ParseUrl

The IDLnetOGCWCS::ParseUrl procedure method breaks down a given, valid URL to a remote WCS server into component parts and sets the corresponding IDLnetOGCWCS properties. This method will set the following properties assuming a URL has each component:

URL_HOSTNAME

URL_SCHEME

URL_PATH

URL_QUERY_PREFIX

URL_PORT

URL_QUERY_SUFFIX

See Translating a URL into Property Values for more information on how URL components map to IDLnetOGCWCS properties.

Note: The URL_PATH and URL_HOSTNAME properties must be set before requesting information from a remote WCS server. You can either set these properties manually or pass a URL to this method prior to making a request.

This method will throw an error if the parsing process fails. Always use a known, working URL as the argument.

Syntax


Obj->[IDLnetOGCWCS::]ParseUrl, URL

Arguments


URL

A string argument containing a known, working URL to an OGC server from which data will be requested.

Note: A valid WCS server URL must minimally include scheme://hostname/path? where ? indicates the end of the path.

Keywords


None

Examples


Create an IDLnetOGCWCS object and call the ParseURL method to populate required properties. In this example use a URL of your choosing or input the following, entered as a single line at the command prompt when requested.

http://217.37.214.210/cgi-bin/test?REQUEST=DescribeCoverage&Service=WCS&Coverage=ERA__Temperature

Note: You may need to use a different URL in the following example as there is no guarantee that the given OCG server will be available when you attempt to establish the connection.

PRO ogcparseurl_doc
 
; Create OGC WCS object.
oWcs = OBJ_NEW("IDLnetOGCWCS")
 
; Enter known working URL at command line to parse.
v=dialog_message("Enter URL at command prompt", /INFO)
url = ''
READ, url, PROMPT='Enter URL: '
oWcs->ParseUrl, STRING(url)
 
; Get properties to see how URL portions are assigned.
oWcs->GetProperty, URL_HOSTNAME=uhost, URL_PATH=upath,$
   URL_PORT=uport, URL_SCHEME=uscheme, $
   URL_QUERY_PREFIX=uprefix, URL_QUERY_SUFFIX=usuffix
 
PRINT, "HOST = " + uhost 
PRINT, "PATH = " + upath
PRINT, "PORT = " + uport
PRINT, "SCHEME = " + uscheme
PRINT, "PREFIX = " + uprefix
PRINT, "SUFFIX = " + usuffix
 
; Cleanup. 
OBJ_DESTROY, oWcs
 
END

Given the URL noted above, IDL prints:

host = 217.37.214.210
path = cgi-bin/test
port = 80
scheme = http
prefix = 
suffix = Coverage=ERA__Temperature

Version History


6.4

Introduced



© 2018 Harris Geospatial Solutions, Inc. |  Legal
My Account    |    Store    |    Contact Us