在云中构建天气跟踪应用程序,第 2 部分
现在让我们添加来自 IBM 的新 Insights for Weather 服务,并开始使用来自第 1 部分的城市信息跟踪您选择的 5 个世界城市的天气。您还将了解如何将您的最终应用程序托管在 IBM Bluemix 上。
运行示例应用程序
获取示例应用程序的代码
观看 Vikram 逐步演示代码
抄本完成您的应用程序的前提条件
参见第 1 部分 了解必备知识和软件。
第 1 步. 初始化一个 Insights for Weather Service 实例
因为存储数据库中的每个位置记录还包含该位置的纬度和经度,所以您现在可以将您的应用程序与 Insights for Weather 服务相集成。最初,此服务实例将在一种未绑定状态下运行;这使您能够在本地开发应用程序,而将服务实例本身远程托管在 Bluemix 上。
阅读: Insights for Weather 入门
- 要创建一个新 Insights for Weather 实例,可以登录到您的Bluemix 帐户,在仪表板中单击 Use Services or APIs 按钮。从得到的服务列表中选择 Insights for Weather 。
- 检查该服务的描述并单击 CREATE 来启动它。确保 App 字段被设置为 Leave unbound ,而且您使用的是 Free Plan 。
- 该服务实例现在将被初始化,您会看到一个服务信息页面。记下服务名称,您在需要使用它。左侧会显示一个导航栏,单击 Service Credentials 查看该服务实例的访问细节。
- 将 url 字段的内容复制到应用程序的 $APP_ROOT /config.php 文件中的 weather_uri 键中。这使您的应用程序能够连接到远程 Insights for Weather 实例并开始从中检索天气数据。
第 2 步. 显示当前天气数据
- 要使用 Insights for Weather 服务,只需请求上一节中显示的服务 URL 并向它附加 API 签名。例如,一个针对 API 端点 https://USERNAME:PASSWORD@twcservice.mybluemix.net/api/weather/v2/observations/current?units=m&language=en-US&geocode=51.50853-0.12574 的请求将生成以下响应,该响应显示了伦敦的当前天气:
- 具体地讲,JSON 输出包括当前天气的描述性短语(例如 “Partly cloudy”),以及当前温度、风速、湿度和其他数据。要在您的应用程序中显示同样的信息,可以更新 /index 路由处理函数来检索存储的位置列表;然后连接到上面显示的 Insights for Weather 服务来检索每个位置的当前天气条件:
get('/', function () use ($app) { return $app->redirect($app["url_generator"]->generate('index'));});$app->get('/index', function () use ($app, $db) { // get list of locations from database // for each location, get current weather from Weather service $collection = $db->locations; $locations = iterator_to_array($collection->find()); foreach ($locations as &$location) { $uri = $app->config['weather_uri'] . '/api/weather/v2/observations/current?units=m&language=en-US&geocode=' . urlencode(sprintf('%f,%f', $location['lat'], $location['lng'])); $json = file_get_contents($uri); if ($json === FALSE) { throw new Exception("Could not connect to Weather API."); } $location['weather'] = json_decode($json, true); } return $app['twig']->render('index.twig', array('locations' => $locations));})->bind('index');
- 接下来,更新 $APP_ROOT /views/index.twig 上的 Twig 模板以显示此信息:
Current Weather
- {% for item in locations %}
- {{ item.location }}, {{ item.country }}
{{ item.weather.observation.metric.temp }}° C | {{ item.weather.observation.phrase_22char }} Remove {% endfor %}
- {{ item.location }}, {{ item.country }}
- 这是该模板的外观。如果更喜欢使用图标代替文本,Insights for Weather 服务提供了一组完整的图标,以及如何使用它们的 说明 。
请注意,每个位置的旁边都有一个 Delete 按钮,它链接到 /delete 路由处理函数,并将该位置的唯一 MongoDB 记录标识符传递给此处理函数。 /delete 处理函数将从 MongoDB 数据库中删除指定的记录:
get('/delete/{id}', function ($id) use ($app, $db) { $collection = $db->locations; $collection->remove(array('_id' => new MongoId($id))); return $app->redirect($app["url_generator"]->generate('index'));})->bind('delete');
第 3 步. 检索天气预报
- 就像您可以检索任何位置的当前天气条件一样,Insights for Weather 服务还允许您检索该位置的 10 天内的天气预报。将您的 API 请求更新为 https://USERNAME:PASSWORD@twcservice.mybluemix.net/api/weather/v2/forecast/daily/10day?units=m&language=en-US&geocode=51.50853-0.12574 ,您将收到白天和晚上的天气条件的详细信息,如下所示。请注意输入中的 dow 和 narrative 字段,它表示星期几和这一天的预报信息片段,因为这些是应用程序使用的主要字段。
- 要将此功能添加到您的应用程序中,可为 /forecast 路由创建一个新处理函数,向它传递数据库中的位置标识符,然后将该值的坐标插入到上面的 API 请求中。以下是相关代码:
get('/forecast/{id}', function ($id) use ($app, $db) { // look up location record in database // connect and get forecast from Weather service $collection = $db->locations; $location = (array)$collection->findOne(array('_id' => new MongoId($id))); $uri = $app->config['weather_uri'] . '/api/weather/v2/forecast/daily/10day?units=m&language=en-US&geocode=' . urlencode(sprintf('%f,%f', $location['lat'], $location['lng'])); $json = file_get_contents($uri); if ($json === FALSE) { throw new Exception("Could not connect to Weather API."); } $location['weather'] = json_decode($json, true); return $app['twig']->render('forecast.twig', array('data' => $location));})->bind('forecast');
- 您还可以为这个新处理函数添加一个页面模板,并从主索引页面链接到它。可以在应用程序的代码存储库中找到该模板。以下是该选项卡的示例:
第 4 步. 将您的应用程序部署到 IBM Bluemix
此刻,该应用程序已完成,您可以将它部署到 Bluemix 了。
- 首先,更新应用程序配置文件并修改数据库凭证,让它们指向您的远程 MongoDB 数据库部署。
- 然后,创建应用程序清单文件,记住通过附加一个随即字符串(比如您姓名的首字母)来使用唯一的主机和应用程序名称。
---applications:- name: weather-tracker-[initials]memory: 256Minstances: 1host: weather-tracker-[initials]buildpack: https://github.com/cloudfoundry/php-buildpack.gitstack: cflinuxfs2
- CloudFoundry PHP buildpack 默认情况下不包含 PHP MongoDB 扩展,所以您必须配置该 buildpack,以便在部署期间启用该扩展。另外,如果您希望自动从 Bluemix 获取 Insights for Weather 服务凭证,那么可以更新该代码来使用 Bluemix VCAP_SERVICES 变量,如下所示:
config['weather_uri'] = $services_json["weatherinsights"][0]["credentials"]["url"];}
- 您现在看可以继续将该应用程序推送到 Bluemix,然后将 Insights for Weather 服务绑定到该应用程序。
shell> cf api https://api.ng.bluemix.netshell> cf loginshell> cf pushshell> cf bind-service weather-tracker-[initials] "Insights for Weather-[id]"shell> cf restage weather-tracker-[initials]
现在可以浏览到应用程序清单中指定的主机来开始使用该应用程序,例如 http://weather-tracker- [initials] .mybluemix.net。如果看到一个空白页或其他错误,可以尝试调试您的 PHP 代码来查找出错的地方。
阅读: 在 IBM Bluemix 上调试 PHP 错误
结束语
Insights for Weather 服务使得将特定于位置的天气数据和预报添加到移动或 Web 应用程序变得很容易。因为您可以通过 REST API 访问该服务,因此可以将它与任何编程语言相集成。此外,因为该服务托管在 Bluemix 上,所以很容易将它连接到您由 Bluemix 托管的应用程序,只需将该服务绑定到您的应用程序并重新载入它。
您可以从上面的链接下载本教程中实现的所有代码,以及 PHP buildpack 的配置文件。推荐您获取该代码,使用它,并尝试添加一些新特性。我保证您不会造成任何破坏,而且它肯定对您的学习有所帮助。祝您开发愉快!