{"id":51983,"date":"2009-11-18T00:01:00","date_gmt":"2009-11-18T00:01:00","guid":{"rendered":"https:\/\/blogs.technet.microsoft.com\/heyscriptingguy\/2009\/11\/18\/hey-scripting-guy-how-can-i-use-a-web-service-to-find-weather-for-a-specific-city\/"},"modified":"2009-11-18T00:01:00","modified_gmt":"2009-11-18T00:01:00","slug":"hey-scripting-guy-how-can-i-use-a-web-service-to-find-weather-for-a-specific-city","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/scripting\/hey-scripting-guy-how-can-i-use-a-web-service-to-find-weather-for-a-specific-city\/","title":{"rendered":"Hey, Scripting Guy! How Can I Use a Web Service to Find Weather for a Specific City?"},"content":{"rendered":"

\"Bookmark<\/a><\/p>\n

 <\/p>\n

\"Hey,<\/p>\n

Hey, Scripting Guy! I thought your script yesterday<\/a> was pretty cool, but there is a problem with it. Retrieving the weather from a script is awesome; however, I need to know which cities are available. If I want to know the weather in Sydney, Australia (your example), I am all set. I’m sure you can see this coming: I do not live in Sydney and therefore the script is useless. How about displaying a list of available cities so that I can figure out how to use the script?<\/p>\n

— NR<\/p>\n

\"Hey,Hello NR, <\/p>\n

I am listening to the Travelling Wilburys<\/font><\/a> on my new Zune HD. It is an absolutely gorgeous day outside—deep blue cloudless skies and a temperature of 69 degrees Fahrenheit (20.5 degrees Celsius). I have opened all the windows in my scripting house, and I am reclining in my large leather scripting chair checking the scripting e-mail sent to scripter@microsoft.com<\/font><\/a> on my Windows 7 scripting laptop. I have a fresh pot of scripting English Breakfast tea<\/font><\/a>, lemon grass, and cinnamon stick. It is a perfect way to enjoy the mellow Charlotte, North Carolina, weather after the weeklong deluge gifted to the area by tropical storm Ida. NR, you are right about the practicality of knowing the weather in Sydney, Australia. Whereas I might dream of heading back to Australia, with the realities of the current budget crunch, I probably will not make it back to Australia before 2011. Therefore, I better see if I can check out the weather report for Charlotte, North Carolina. <\/p>\n

NR, the Get-InternationalCities.ps1 script uses the globalweather<\/b> Web service and the GetCitiesByCountry<\/b> method to return a list of available cities. The complete Get-InternationalCities.ps1 script follows. <\/p>\n

Get-InternationalCities.ps1<\/strong><\/p>\n

$country = “united states”
$URI = “http:\/\/www.webservicex.net\/globalweather.asmx?wsdl”
$Proxy = New-WebServiceProxy -uri $URI -namespace WebServiceProxy
$countries = [xml]$proxy.GetCitiesByCountry($country)
$countries.NewDataSet.Table | Sort-Object -Property city |
Select-Object -Property city<\/font><\/p>\n

The first thing the Get-InternationalCities.ps1 script does is assign a value for the $country<\/b> variable. The value of the $country<\/b> variable is used to retrieve the list of cities. This is shown here:<\/p>\n

$country = “united states”<\/font><\/p>\n

After the country has been set for the script, you need to assign the path to the globalweather<\/b> Web Service Definition Language (WSDL) to the $URI<\/b> variable. The WSDL is an XML document that describes the service offering. Because the WSDL string is a Uniform Resource Locator (URL), you can open it directly in Internet Explorer and look for methods and properties described by the WSDL. The following image illustrates this:<\/p>\n

\"Image<\/p>\n


After you assign the path to the $URI<\/b> variable, you can use the New-WebServiceProxy<\/b> cmdlet to create a Web service proxy that allows you to connect and to retrieve information from the globalweather<\/b> Web service. The returned object is a special webserviceproxy<\/b> object that is created from the Web service that is specified in the $URI<\/b> variable. The members of the WebServiceProxy.GlobalWeather<\/b> object are shown here:<\/p>\n

   <\/span>TypeName: WebServiceProxy.GlobalWeather<\/p>\n

Name                                 <\/span>MemberType Definition                                              <\/span>
—-                                 <\/span>———- ———-                                              <\/span>
Disposed                             <\/span>Event      <\/span>System.EventHandler Disposed(System.Object, System.Ev…
GetCitiesByCountryCompleted          <\/span>Event      <\/span>WebServiceProxy.GetCitiesByCountryCompletedEventHandl…
GetWeatherCompleted                  <\/span>Event      <\/span>WebServiceProxy.GetWeatherCompletedEventHandler GetWe…
Abort                               <\/span> <\/span>Method     <\/span>System.Void Abort()                                     <\/span>
BeginGetCitiesByCountry              <\/span>Method     <\/span>System.IAsyncResult BeginGetCitiesByCountry(string Co…
BeginGetWeather                      <\/span>Method     <\/span>System.IAsyncResult BeginGetWeather(string CityName, …
CancelAsync                          <\/span>Method     <\/span>System.Void CancelAsync(System.Object userState)        <\/span>
CreateObjRef                         <\/span>Method     <\/span>System.Runtime.Remoting.ObjRef CreateObjRef(type requ…
Discover               <\/span>              <\/span>Method     <\/span>System.Void Discover()                                  <\/span>
Dispose                              <\/span>Method     <\/span>System.Void Dispose()                                   <\/span>
EndGetCitiesByCountry                <\/span>Method     <\/span>string EndGetCitiesByCountry(System.IAsyncResult asyn…
EndGetWeather                        <\/span>Method     <\/span>string EndGetWeather(System.IAsyncResult asyncResult)   <\/span>
Equals                               <\/span>Method     <\/span>bool Equals(System.Object obj)                          <\/span>
GetCitiesByCountry                   <\/span>Method     <\/span>string GetCitiesByCountry(string CountryName)           <\/span>
GetCitiesByCountryAsync              <\/span>Method     <\/span>System.Void GetCitiesByCountryAsync(string CountryNam…
GetHashCode                          <\/span>Method     <\/span>int GetHashCode()                                       <\/span>
GetLifetimeService                   <\/span>Method     <\/span>System.Object GetLifetimeService()                      <\/span>
GetType                              <\/span>Method     <\/span>type GetType()                                        <\/span>  <\/span>
GetWeather                           <\/span>Method     <\/span>string GetWeather(string CityName, string CountryName)  <\/span>
GetWeatherAsync                      <\/span>Method     <\/span>System.Void GetWeatherAsync(string CityName, string C…
InitializeLifetimeService            <\/span>Method     <\/span>System.Object InitializeLifetimeService()               <\/span>
ToString                             <\/span>Method     <\/span>string ToString()                                       <\/span>
AllowAutoRedirect                    <\/span>Property   <\/span>System.Boolean AllowAutoRedirect {get;set;}             <\/span>
ClientCertificates                   <\/span>Property   <\/span>System.Security.Cryptography.X509Certificates.X509Cer…
ConnectionGroupName                  <\/span>Property   <\/span>System.String ConnectionGroupName {get;set;}            <\/span>
Container                     <\/span>       <\/span>Property   <\/span>System.ComponentModel.IContainer Container {get;}       <\/span>
CookieContainer                      <\/span>Property   <\/span>System.Net.CookieContainer CookieContainer {get;set;}   <\/span>
Credentials                          <\/span>Property   <\/span>System.Net.ICredentials Credentials {get;set;}          <\/span>
EnableDecompression                  <\/span>Property   <\/span>System.Boolean EnableDecompression {get;set;}           <\/span>
PreAuthenticate                      <\/span>Property   <\/span>System.Boolean PreAuthenticate {get;set;}               <\/span>
Proxy            <\/span>                    <\/span>Property   <\/span>System.Net.IWebProxy Proxy {get;set;}                   <\/span>
RequestEncoding                      <\/span>Property   <\/span>System.Text.Encoding RequestEncoding {get;set;}         <\/span>
Site                                 <\/span>Property   <\/span>System.ComponentModel.ISite Site {get;set;}             <\/span>
SoapVersion                          <\/span>Property   <\/span>System.Web.Services.Protocols.SoapProtocolVersion Soa…
Timeout                              <\/span>Property   <\/span>System.Int32 Timeout {get;set;}                         <\/span>
UnsafeAuthenticatedConnectionSharing Property   <\/span>System.Boolean UnsafeAuthenticatedConnectionSharing {…
Url                                  <\/span>Property   <\/span>System.String Url {get;set;}                            <\/span>
UseDefaultCredentials                <\/span>Property   <\/span>System.Boolean UseDefaultCredentials {get;set;}         <\/span>
UserAgent                            <\/span>Property   <\/span>System.String UserAgent {get;set;}              <\/span><\/font><\/font><\/p>\n

The name webserviceproxy<\/b> comes from the value we specified for the namespace<\/b> parameter with the New-WebServiceProxy<\/b> cmdlet. This is seen here:<\/p>\n

$URI = “http:\/\/www.webservicex.net\/globalweather.asmx?wsdl”
$Proxy = New-WebServiceProxy -uri $URI -namespace WebServiceProxy<\/font><\/p>\n

The properties of the new Web service proxy are displayed by printing the value stored in the $Proxy<\/b> variable as shown here:<\/p>\n

PS C:Usersed.NWTRADERS> $proxy<\/p>\n


SoapVersion                          <\/span>: Default
AllowAutoRedirect                    <\/span>: False
CookieContainer                      <\/span>:
ClientCertificates                   <\/span>: {}
EnableDecompression                  <\/span>: False
UserAgent                            <\/span>: Mozilla\/4.0 (compatible; MSIE 6.0; MS Web Services Client Protoco
                                       <\/span>l 2.0.50727.4927)
Proxy                                <\/span>:
UnsafeAuthenticatedConnectionSharing : False
Credentials                          <\/span>:
UseDefaultCredentials                <\/span>: False
ConnectionGroupName                  <\/span>:
PreAuthenticate                      <\/span>: False
Url                                  <\/span>: http:\/\/www.webservicex.net\/globalweather.asmx
RequestEncoding                      <\/span>:
Timeout                              <\/span>: 100000
Site                                 <\/span>:
Container                            <\/span>:<\/font><\/p>\n

Once the WebServiceProxy.GlobalWeather<\/b> object is created, the GetCitiesByCountry<\/b> method is called. The Get-Member<\/b> cmdlet can be used to provide a clue to the input required by the GetCitiesByCountry<\/b> method (although it would seem rather obvious that the method wants a string that represents the country to query). This is shown here:<\/p>\n

PS C:Usersed.NWTRADERS> $Proxy | Get-Member -Name GetCitiesByCountry<\/p>\n


   <\/span>TypeName: WebServiceProxy.GlobalWeather<\/p>\n

Name               <\/span>MemberType Definition                                   <\/span>
—-               <\/span>———- ———-             <\/span>                      <\/span>
GetCitiesByCountry Method     <\/span>string GetCitiesByCountry(string CountryName)<\/font><\/p>\n

The data that is returned by the GetCitiesByCountry<\/b> method is in the form of a data set with tables that represent each city\/country combination. This is seen here:<\/p>\n

PS C:Usersed.NWTRADERS> $Proxy.GetCitiesByCountry(“mexico”)
<NewDataSet>
  <\/span><Table>
    <\/span><Country>Mexico<\/Country>
    <\/span><City>Acapulco \/ G. Alvarez<\/City>
  <\/span><\/Table>
  <\/span><Table>
    <\/span><Country>Mexico<\/Country>
    <\/span><City>Aerop. Internacional Monterrey, N. L.<\/City>
  <\/span><\/Table>
  <\/span><Table>
    <\/span><Country>Mexico<\/Country>
    <\/span><City>Aguascalientes, Ags.<\/City>
  <\/span><\/Table>
  <\/span><Table>
    <\/span><Country>Mexico<\/Country>
    <\/span><City>Bahias De Huatulco<\/City>
  <\/span><\/Table>
  <\/span><Table>
    <\/span><Country>Mexico<\/Country>
    <\/span><City>Cuernavaca, Mor.<\/City>
<\/span><\/font><\/p>\n","protected":false},"excerpt":{"rendered":"

  Hey, Scripting Guy! I thought your script yesterday was pretty cool, but there is a problem with it. Retrieving the weather from a script is awesome; however, I need to know which cities are available. If I want to know the weather in Sydney, Australia (your example), I am all set. I’m sure you […]<\/p>\n","protected":false},"author":595,"featured_media":87096,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1],"tags":[3,4,45,165],"class_list":["post-51983","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-scripting","tag-scripting-guy","tag-scripting-techniques","tag-windows-powershell","tag-xml"],"acf":[],"blog_post_summary":"

  Hey, Scripting Guy! I thought your script yesterday was pretty cool, but there is a problem with it. Retrieving the weather from a script is awesome; however, I need to know which cities are available. If I want to know the weather in Sydney, Australia (your example), I am all set. I’m sure you […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51983","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/users\/595"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/comments?post=51983"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/posts\/51983\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media\/87096"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/media?parent=51983"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/categories?post=51983"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/scripting\/wp-json\/wp\/v2\/tags?post=51983"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}