README

此库提供了 Zillow API 的 PHP 接口。

查看：[zillow.com](http://www.zillow.com/howto/api/APIOverview.htm) 以获取更多信息。

目前，只支持以下 API 调用
http://www.zillow.com/howto/api/GetSearchResults.htm
http://www.zillow.com/howto/api/GetChart.htm
http://www.zillow.com/howto/api/GetComps.htm

如果您真的很想看到某个 API 被实现，您可以在 [GitHub](https://github.com/VerticalTab/Pillow/issues) 上创建一个 问题，或者 fork，实现并提交一个 pull request。

要求

PHP >= 5.3

安装

首选的安装方法是 composer。在您项目的根目录（不是 Web 根目录）中创建一个最小的 composer.json 文件

{
    "require": {
        "VerticalTab/Pillow": "x.x.x"
    }
}

将上面的 "x.x.x" 替换为您想使用的标签号。注意：请参阅 [VeriticalTab/Pillow Packagist 页面](https://packagist.org.cn/packages/VerticalTab/Pillow) 以获取最新发布信息。

接下来，获取 composer 并使用它进行安装（再次，在您的项目根目录中）

$ wget https://getcomposer.org.cn/composer.phar
$ php composer.phar install

这会将库放入您的 vendors 目录。

更新

安装后更新，请编辑 composer.json 中的 "require" 部分。然后更新

$ php composer.phar update

示例

文件：simple.php

<?php
require 'vendor/autoload.php';

use VerticalTab\Pillow\Service;

$key = 'your zillow api key';
$s = new Service($key);
$results = $s->getSearchResults('2114 Bigelow Ave', '98109');
$property = $results->current();

"Results:" . PHP_EOL;
echo "zpid      : " . $property->zpid . PHP_EOL;
echo "city      : " . $property->city . PHP_EOL;

运行简单示例

$ php simple.php

文件：chart.php

<?php
require 'vendor/autoload.php';

use VerticalTab\Pillow\Service;

$key = 'your zillow api key';
$s = new Service($key);
$results = $s->getSearchResults('2114 Bigelow Ave', '98109');
$property = $results->current();

echo "chart url : " . $property->chart->url . PHP_EOL;

运行图表示例

$ php chart.php

文件：comps.php

<?php
require 'vendor/autoload.php';

use VerticalTab\Pillow\Service;

$key = 'your zillow api key';
$s = new Service($key);
$results = $s->getSearchResults('2114 Bigelow Ave', '98109');
$property = $results->current();

foreach($property->comps as $i => $comp) {
  echo "\tcomp      : " . $i . PHP_EOL;
  echo "\tzpid      : " . $comp->zpid . PHP_EOL;
  echo "\tzestimate : " . $comp->zestimate->amount . PHP_EOL;
  echo PHP_EOL;
}

运行比较示例

$ php comps.php