1: <?php
 2: /**
 3:  * Magento
 4:  *
 5:  * NOTICE OF LICENSE
 6:  *
 7:  * This source file is subject to the Open Software License (OSL 3.0)
 8:  * that is bundled with this package in the file LICENSE.txt.
 9:  * It is also available through the world-wide-web at this URL:
10:  * http://opensource.org/licenses/osl-3.0.php
11:  * If you did not receive a copy of the license and are unable to
12:  * obtain it through the world-wide-web, please send an email
13:  * to license@magentocommerce.com so we can send you a copy immediately.
14:  *
15:  * DISCLAIMER
16:  *
17:  * Do not edit or add to this file if you wish to upgrade Magento to newer
18:  * versions in the future. If you wish to customize Magento for your
19:  * needs please refer to http://www.magentocommerce.com for more information.
20:  *
21:  * @category    Mage
22:  * @package     Mage_Directory
23:  * @copyright   Copyright (c) 2012 Magento Inc. (http://www.magentocommerce.com)
24:  * @license     http://opensource.org/licenses/osl-3.0.php  Open Software License (OSL 3.0)
25:  */
26: 
27: /**
28:  * Directory Region Api
29:  *
30:  * @category   Mage
31:  * @package    Mage_Directory
32:  * @author     Magento Core Team <core@magentocommerce.com>
33:  */
34: class Mage_Directory_Model_Region_Api extends Mage_Api_Model_Resource_Abstract
35: {
36:     /**
37:      * Retrieve regions list
38:      *
39:      * @param string $country
40:      * @return array
41:      */
42:     public function items($country)
43:     {
44:         try {
45:             $country = Mage::getModel('directory/country')->loadByCode($country);
46:         } catch (Mage_Core_Exception $e) {
47:             $this->_fault('country_not_exists', $e->getMessage());
48:         }
49: 
50:         if (!$country->getId()) {
51:             $this->_fault('country_not_exists');
52:         }
53: 
54:         $result = array();
55:         foreach ($country->getRegions() as $region) {
56:             $region->getName();
57:             $result[] = $region->toArray(array('region_id', 'code', 'name'));
58:         }
59: 
60:         return $result;
61:     }
62: } // Class Mage_Directory_Model_Region_Api End
63: