rvp_php_sdk_place.class.php

<?php
/***************************************************************************************************************************/
defined( 'RVP_PHP_SDK_ACCESS' ) or die ( 'Cannot Execute Directly' );   // Makes sure that this file is in the correct context.

require_once(dirname(__FILE__).'/a_rvp_php_sdk_data_object.class.php');   // Make sure that we have the base class in place.

/****************************************************************************************************************************/
class RVP_PHP_SDK_Place extends A_RVP_PHP_SDK_Data_Object {
    /************************************************************************************************************************/    
    /*#################################################### INTERNAL METHODS ################################################*/
    /************************************************************************************************************************/
    /***********************/
    protected function _save_data(  $in_args = '',              
                                    $in_payload = NULL,         
                                    $in_new_child_ids = NULL    
                                ) {
        $to_set = [
            'address_venue' => (isset($this->_object_data->address_elements->venue) ? $this->_object_data->address_elements->venue : NULL),
            'address_street_address' => (isset($this->_object_data->address_elements->street_address) ? $this->_object_data->address_elements->street_address : NULL),
            'address_extra_information' => (isset($this->_object_data->address_elements->extra_information) ? $this->_object_data->address_elements->extra_information : NULL),
            'address_town' => (isset($this->_object_data->address_elements->town) ? $this->_object_data->address_elements->town : NULL),
            'address_county' => (isset($this->_object_data->address_elements->county) ? $this->_object_data->address_elements->county : NULL),
            'address_state' => (isset($this->_object_data->address_elements->state) ? $this->_object_data->address_elements->state : NULL),
            'address_postal_code' => (isset($this->_object_data->address_elements->postal_code) ? $this->_object_data->address_elements->postal_code : NULL),
            'address_nation' => (isset($this->_object_data->address_elements->nation) ? $this->_object_data->address_elements->nation : NULL),
            'tag8' => (isset($this->_object_data->tag8) ? $this->_object_data->tag8 : NULL),
            'tag9' => (isset($this->_object_data->tag9) ? $this->_object_data->tag9 : NULL)
            ];
        
        $put_args = '';
        
        foreach ($to_set as $key => $value) {
            if (isset($key) && isset($value)) {
                $put_args .= '&'.$key.'='.urlencode(trim(strval($value)));
            }
        }
        
        $ret = parent::_save_data($put_args.$in_args, NULL, NULL);
        
        return $ret;
    }
        
    /***********************/
    protected function _save_change_record( $in_change_record_object    
                                            ) {
        $ret = false;
      
        if (isset($in_change_record_object->places) && isset($in_change_record_object->places->changed_places) && is_array($in_change_record_object->places->changed_places) && count($in_change_record_object->places->changed_places)) {
            foreach ($in_change_record_object->places->changed_places as $changed_place) {
                if ($before = $changed_place->before) {
                    $this->_changed_states[] = new RVP_PHP_SDK_Place($this->_sdk_object, $before->id, $before, true);
                    $ret = true;
                }
            }
        }
        
        return $ret;
    }
    
    /***********************/
    protected function _load_data(  $in_force = false,      
                                    $in_details = false,    
                                    $in_parents = false     
                                ) {
        $ret = parent::_load_data($in_force, $in_details, $in_parents);
        
        if ($ret) {
            if (isset($this->_object_data) && isset($this->_object_data->places) && isset($this->_object_data->places->results) && is_array($this->_object_data->places->results) && (1 == count($this->_object_data->places->results))) {
                $this->_object_data = $this->_object_data->places->results[0];
            } else {
                $this->_object_data = NULL;
                $this->_details = false;
            }
        }
        return $ret;
    }

    /************************************************************************************************************************/    
    /*#################################################### PUBLIC METHODS ##################################################*/
    /************************************************************************************************************************/
    
    /***********************/
    function __construct(   $in_sdk_object,             
                            $in_id,                     
                            $in_data = NULL,            
                            $in_detailed_data = false   
                        ) {
        parent::__construct($in_sdk_object, $in_id, $in_data, $in_detailed_data, 'places');
    }
    
    /***********************/
    function basic_address() {
        $ret = NULL;
        
        $this->_load_data();
        
        if (isset($this->_object_data) && isset($this->_object_data->address)) {
            $ret = $this->_object_data->address;
        }
        
        return $ret;
    }
    
    /***********************/
    function address_elements() {
        $ret = NULL;
        
        $this->_load_data(false, true);
        
        if (isset($this->_object_data) && isset($this->_object_data->address_elements)) {
            $ret = (array)$this->_object_data->address_elements;
        }
        
        return $ret;
    }
    
    /***********************/
    function set_address_elements(  $in_address_elements_array  
                                ) {
        
        $ret = false;
        
        $this->_load_data(false, true);
        
        if (isset($this->_object_data)) {
            foreach($in_address_elements_array as $key => $value) {
                $key = strtolower(trim(strval($key)));
                $value = trim(strval($value));
                $this->_object_data->address_elements->$key = $value;
            }
            
            $ret = $this->save_data();
            
            $this->_load_data(true, true);  // Force a reload.
        }
        
        return $ret;
    }
    
    /***********************/
    function tag8() {
        $ret = NULL;
        
        $this->_load_data(false, true);
        
        if (isset($this->_object_data)) {
            $ret = $this->_object_data->tag8;
        }
        
        return $ret;
    }
    
    /***********************/
    function tag9() {
        $ret = NULL;
        
        $this->_load_data(false, true);
        
        if (isset($this->_object_data)) {
            $ret = $this->_object_data->tag9;
        }
        
        return $ret;
    }
    
    /***********************/
    function set_tag8(  $in_new_string_value    
                    ) {
        $ret = false;
        
        $this->_load_data(false, true);
        
        if (isset($this->_object_data)) {
            $this->_object_data->tag8 = trim(strval($in_new_string_value));
            $ret = $this->save_data();
        }
        
        return $ret;
    }
    
    /***********************/
    function set_tag9(  $in_new_string_value    
                    ) {
        $ret = false;
        
        $this->_load_data(false, true);
        
        if (isset($this->_object_data)) {
            $this->_object_data->tag9 = trim(strval($in_new_string_value));
            $ret = $this->save_data();
        }
        
        return $ret;
    }
    
    /***********************/
    function geocode() {
        $ret = false;

        $result = json_decode($this->_sdk_object->put_data('/json/'.$this->_plugin_path.'/'.$this->id(), 'geocode'));
        
        if (isset($result) && $result) {
            $this->_save_change_record($result);
        }
        
        $this->_load_data(true, true);
        
        return $ret;
    }
    
    /***********************/
    function reverse_geocode() {
        $ret = false;

        $result = json_decode($this->_sdk_object->put_data('/json/'.$this->_plugin_path.'/'.$this->id(), 'reverse-geocode'));
        
        if (isset($result) && $result) {
            $this->_save_change_record($result);
        }
        
        $this->_load_data(true, true);
        
        return $ret;
    }
};