@@ -17,43 +17,43 @@ |
||
| 17 | 17 | class GoogleMapsResponseFields |
| 18 | 18 | { |
| 19 | 19 | |
| 20 | - /** |
|
| 21 | - * @var string results |
|
| 22 | - */ |
|
| 23 | - const RESULTS = 'results'; |
|
| 24 | - |
|
| 25 | - /** |
|
| 26 | - * @var string result |
|
| 27 | - * @since v0.6.0 |
|
| 28 | - */ |
|
| 29 | - const RESULT = 'result'; |
|
| 30 | - |
|
| 31 | - /** |
|
| 32 | - * @var string status |
|
| 33 | - */ |
|
| 34 | - const STATUS = 'status'; |
|
| 35 | - |
|
| 36 | - /** |
|
| 37 | - * @var string error_message |
|
| 38 | - */ |
|
| 39 | - const ERROR_MESSAGE = 'error_message'; |
|
| 40 | - |
|
| 41 | - /** |
|
| 42 | - * @var string candidates |
|
| 43 | - * @since 0.5.0 |
|
| 44 | - */ |
|
| 45 | - const CANDIDATES = 'candidates'; |
|
| 46 | - |
|
| 47 | - /** |
|
| 48 | - * @var string html_attributions |
|
| 49 | - * @since 0.5.0 |
|
| 50 | - */ |
|
| 51 | - const HTML_ATTRIBUTIONS = 'html_attributions'; |
|
| 52 | - |
|
| 53 | - /** |
|
| 54 | - * @var string next_page_token |
|
| 55 | - * @since 0.5.0 |
|
| 56 | - */ |
|
| 57 | - const NEXT_PAGE_TOKEN = 'next_page_token'; |
|
| 20 | + /** |
|
| 21 | + * @var string results |
|
| 22 | + */ |
|
| 23 | + const RESULTS = 'results'; |
|
| 24 | + |
|
| 25 | + /** |
|
| 26 | + * @var string result |
|
| 27 | + * @since v0.6.0 |
|
| 28 | + */ |
|
| 29 | + const RESULT = 'result'; |
|
| 30 | + |
|
| 31 | + /** |
|
| 32 | + * @var string status |
|
| 33 | + */ |
|
| 34 | + const STATUS = 'status'; |
|
| 35 | + |
|
| 36 | + /** |
|
| 37 | + * @var string error_message |
|
| 38 | + */ |
|
| 39 | + const ERROR_MESSAGE = 'error_message'; |
|
| 40 | + |
|
| 41 | + /** |
|
| 42 | + * @var string candidates |
|
| 43 | + * @since 0.5.0 |
|
| 44 | + */ |
|
| 45 | + const CANDIDATES = 'candidates'; |
|
| 46 | + |
|
| 47 | + /** |
|
| 48 | + * @var string html_attributions |
|
| 49 | + * @since 0.5.0 |
|
| 50 | + */ |
|
| 51 | + const HTML_ATTRIBUTIONS = 'html_attributions'; |
|
| 52 | + |
|
| 53 | + /** |
|
| 54 | + * @var string next_page_token |
|
| 55 | + * @since 0.5.0 |
|
| 56 | + */ |
|
| 57 | + const NEXT_PAGE_TOKEN = 'next_page_token'; |
|
| 58 | 58 | |
| 59 | 59 | } |
| 60 | 60 | \ No newline at end of file |
@@ -18,43 +18,43 @@ |
||
| 18 | 18 | class ReviewFields |
| 19 | 19 | { |
| 20 | 20 | |
| 21 | - /** |
|
| 22 | - * @var string |
|
| 23 | - */ |
|
| 24 | - const AUTHOR_NAME = "author_name"; |
|
| 25 | - |
|
| 26 | - /** |
|
| 27 | - * @var string |
|
| 28 | - */ |
|
| 29 | - const AUTHOR_URL = "author_url"; |
|
| 30 | - |
|
| 31 | - /** |
|
| 32 | - * @var string |
|
| 33 | - */ |
|
| 34 | - const LANGUAGE = "language"; |
|
| 35 | - |
|
| 36 | - /** |
|
| 37 | - * @var string |
|
| 38 | - */ |
|
| 39 | - const PROFILE_PHOTO_URL = "profile_photo_url"; |
|
| 40 | - |
|
| 41 | - /** |
|
| 42 | - * @var string |
|
| 43 | - */ |
|
| 44 | - const RATING = "rating"; |
|
| 45 | - |
|
| 46 | - /** |
|
| 47 | - * @var string |
|
| 48 | - */ |
|
| 49 | - const RELATIVE_TIME_DESCRIPTION = "relative_time_description"; |
|
| 50 | - |
|
| 51 | - /** |
|
| 52 | - * @var string |
|
| 53 | - */ |
|
| 54 | - const TEXT = "text"; |
|
| 55 | - |
|
| 56 | - /** |
|
| 57 | - * @var string |
|
| 58 | - */ |
|
| 59 | - const TIME = "time"; |
|
| 21 | + /** |
|
| 22 | + * @var string |
|
| 23 | + */ |
|
| 24 | + const AUTHOR_NAME = "author_name"; |
|
| 25 | + |
|
| 26 | + /** |
|
| 27 | + * @var string |
|
| 28 | + */ |
|
| 29 | + const AUTHOR_URL = "author_url"; |
|
| 30 | + |
|
| 31 | + /** |
|
| 32 | + * @var string |
|
| 33 | + */ |
|
| 34 | + const LANGUAGE = "language"; |
|
| 35 | + |
|
| 36 | + /** |
|
| 37 | + * @var string |
|
| 38 | + */ |
|
| 39 | + const PROFILE_PHOTO_URL = "profile_photo_url"; |
|
| 40 | + |
|
| 41 | + /** |
|
| 42 | + * @var string |
|
| 43 | + */ |
|
| 44 | + const RATING = "rating"; |
|
| 45 | + |
|
| 46 | + /** |
|
| 47 | + * @var string |
|
| 48 | + */ |
|
| 49 | + const RELATIVE_TIME_DESCRIPTION = "relative_time_description"; |
|
| 50 | + |
|
| 51 | + /** |
|
| 52 | + * @var string |
|
| 53 | + */ |
|
| 54 | + const TEXT = "text"; |
|
| 55 | + |
|
| 56 | + /** |
|
| 57 | + * @var string |
|
| 58 | + */ |
|
| 59 | + const TIME = "time"; |
|
| 60 | 60 | } |
| 61 | 61 | \ No newline at end of file |
@@ -17,23 +17,23 @@ |
||
| 17 | 17 | class PlaceServicesEndpoints |
| 18 | 18 | { |
| 19 | 19 | |
| 20 | - /** |
|
| 21 | - * @var string |
|
| 22 | - */ |
|
| 23 | - const FINDPLACEFROMTEXT = "findplacefromtext"; |
|
| 20 | + /** |
|
| 21 | + * @var string |
|
| 22 | + */ |
|
| 23 | + const FINDPLACEFROMTEXT = "findplacefromtext"; |
|
| 24 | 24 | |
| 25 | - /** |
|
| 26 | - * @var string |
|
| 27 | - */ |
|
| 28 | - const NEARBYSEARCH = "nearbysearch"; |
|
| 25 | + /** |
|
| 26 | + * @var string |
|
| 27 | + */ |
|
| 28 | + const NEARBYSEARCH = "nearbysearch"; |
|
| 29 | 29 | |
| 30 | - /** |
|
| 31 | - * @var string |
|
| 32 | - */ |
|
| 33 | - const TEXTSEARCH = "textsearch"; |
|
| 30 | + /** |
|
| 31 | + * @var string |
|
| 32 | + */ |
|
| 33 | + const TEXTSEARCH = "textsearch"; |
|
| 34 | 34 | |
| 35 | - /** |
|
| 36 | - * @var string |
|
| 37 | - */ |
|
| 38 | - const DETAILS = "details"; |
|
| 35 | + /** |
|
| 36 | + * @var string |
|
| 37 | + */ |
|
| 38 | + const DETAILS = "details"; |
|
| 39 | 39 | } |
| 40 | 40 | \ No newline at end of file |
@@ -17,186 +17,186 @@ |
||
| 17 | 17 | class GoogleMapsResultFields |
| 18 | 18 | { |
| 19 | 19 | |
| 20 | - /** |
|
| 21 | - * @var string address_components |
|
| 22 | - */ |
|
| 23 | - const ADDRESS_COMPONENTS = 'address_components'; |
|
| 24 | - |
|
| 25 | - /** |
|
| 26 | - * @var string formatted_address |
|
| 27 | - */ |
|
| 28 | - const FORMATTED_ADDRESS = 'formatted_address'; |
|
| 29 | - |
|
| 30 | - /** |
|
| 31 | - * @var string geometry |
|
| 32 | - */ |
|
| 33 | - const GEOMETRY = 'geometry'; |
|
| 34 | - |
|
| 35 | - /** |
|
| 36 | - * @var string viewport |
|
| 37 | - */ |
|
| 38 | - const VIEWPORT = 'viewport'; |
|
| 39 | - |
|
| 40 | - /** |
|
| 41 | - * @var string place_id |
|
| 42 | - */ |
|
| 43 | - const PLACE_ID = 'place_id'; |
|
| 44 | - |
|
| 45 | - /** |
|
| 46 | - * @var string location_type |
|
| 47 | - */ |
|
| 48 | - const LOCATION_TYPE = 'location_type'; |
|
| 49 | - |
|
| 50 | - /** |
|
| 51 | - * @var string types |
|
| 52 | - */ |
|
| 53 | - const TYPES = 'types'; |
|
| 54 | - |
|
| 55 | - /** |
|
| 56 | - * @var string location |
|
| 57 | - */ |
|
| 58 | - const LOCATION = 'location'; |
|
| 59 | - |
|
| 60 | - /** |
|
| 61 | - * @var string elevation |
|
| 62 | - */ |
|
| 63 | - const ELEVATION = 'elevation'; |
|
| 64 | - |
|
| 65 | - /** |
|
| 66 | - * @var string resolution |
|
| 67 | - */ |
|
| 68 | - const RESOLUTION = 'resolution'; |
|
| 69 | - |
|
| 70 | - /** |
|
| 71 | - * @var string icon |
|
| 72 | - * @since 0.5.0 |
|
| 73 | - */ |
|
| 74 | - const ICON = 'icon'; |
|
| 75 | - |
|
| 76 | - /** |
|
| 77 | - * @var string id |
|
| 78 | - * @since 0.5.0 |
|
| 79 | - */ |
|
| 80 | - const ID = 'id'; |
|
| 81 | - |
|
| 82 | - /** |
|
| 83 | - * @var string name |
|
| 84 | - * @since 0.5.0 |
|
| 85 | - */ |
|
| 86 | - const NAME = 'name'; |
|
| 87 | - |
|
| 88 | - /** |
|
| 89 | - * @var string photos |
|
| 90 | - * @since 0.5.0 |
|
| 91 | - */ |
|
| 92 | - const PHOTOS = 'photos'; |
|
| 93 | - |
|
| 94 | - /** |
|
| 95 | - * @var string reference |
|
| 96 | - * @since 0.5.0 |
|
| 97 | - */ |
|
| 98 | - const REFERENCE = 'reference'; |
|
| 99 | - |
|
| 100 | - /** |
|
| 101 | - * @var string vicinity |
|
| 102 | - * @since 0.5.0 |
|
| 103 | - */ |
|
| 104 | - const VICINITY = 'vicinity'; |
|
| 105 | - |
|
| 106 | - /** |
|
| 107 | - * @var string opening_hours |
|
| 108 | - * @since 0.5.0 |
|
| 109 | - */ |
|
| 110 | - const OPENING_HOURS = 'opening_hours'; |
|
| 111 | - |
|
| 112 | - /** |
|
| 113 | - * @var string price_level |
|
| 114 | - * @since 0.5.0 |
|
| 115 | - */ |
|
| 116 | - const PRICE_LEVEL = 'price_level'; |
|
| 117 | - |
|
| 118 | - /** |
|
| 119 | - * @var string rating |
|
| 120 | - * @since 0.5.0 |
|
| 121 | - */ |
|
| 122 | - const RATING = 'rating'; |
|
| 123 | - |
|
| 124 | - /** |
|
| 125 | - * @var string permanently_closed |
|
| 126 | - * @since 0.5.0 |
|
| 127 | - */ |
|
| 128 | - const PERMANENTLY_CLOSED = 'permanently_closed'; |
|
| 129 | - |
|
| 130 | - /** |
|
| 131 | - * @var string plus_code |
|
| 132 | - * @since 0.5.0 |
|
| 133 | - */ |
|
| 134 | - const PLUS_CODE = 'plus_code'; |
|
| 135 | - |
|
| 136 | - /** |
|
| 137 | - * @var string next_page_token |
|
| 138 | - * @since 0.5.0 |
|
| 139 | - */ |
|
| 140 | - const NEXT_PAGE_TOKEN = 'next_page_token'; |
|
| 141 | - |
|
| 142 | - /** |
|
| 143 | - * @var string reviews |
|
| 144 | - * @since 0.6.0 |
|
| 145 | - */ |
|
| 146 | - const REVIEWS = 'reviews'; |
|
| 147 | - |
|
| 148 | - /** |
|
| 149 | - * @var string utc_offset |
|
| 150 | - * @since 0.6.0 |
|
| 151 | - */ |
|
| 152 | - const UTC_OFFSET = 'utc_offset'; |
|
| 153 | - |
|
| 154 | - /** |
|
| 155 | - * @var string website |
|
| 156 | - * @since 0.6.0 |
|
| 157 | - */ |
|
| 158 | - const WEBSITE = 'website'; |
|
| 159 | - |
|
| 160 | - /** |
|
| 161 | - * @var string international_phone_number |
|
| 162 | - * @since 0.6.0 |
|
| 163 | - */ |
|
| 164 | - const INTERNATIONAL_PHONE_NUMBER = 'international_phone_number'; |
|
| 165 | - |
|
| 166 | - /** |
|
| 167 | - * @var string formatted_phone_number |
|
| 168 | - * @since 0.6.0 |
|
| 169 | - */ |
|
| 170 | - const FORMATTED_PHONE_NUMBER = 'formatted_phone_number'; |
|
| 171 | - |
|
| 172 | - /** |
|
| 173 | - * @var string adr_address |
|
| 174 | - * @since 0.6.0 |
|
| 175 | - */ |
|
| 176 | - const ADR_ADDRESS = 'adr_address'; |
|
| 177 | - |
|
| 178 | - /** |
|
| 179 | - * @var string dstOffset |
|
| 180 | - * @since 0.7.0 |
|
| 181 | - */ |
|
| 182 | - const DST_OFFSET = 'dstOffset'; |
|
| 183 | - |
|
| 184 | - /** |
|
| 185 | - * @var string rawOffset |
|
| 186 | - * @since 0.7.0 |
|
| 187 | - */ |
|
| 188 | - const RAW_OFFSET = 'rawOffset'; |
|
| 189 | - |
|
| 190 | - /** |
|
| 191 | - * @var string timeZoneId |
|
| 192 | - * @since 0.7.0 |
|
| 193 | - */ |
|
| 194 | - const TIMEZONE_ID = 'timeZoneId'; |
|
| 195 | - |
|
| 196 | - /** |
|
| 197 | - * @var string timeZoneName |
|
| 198 | - * @since 0.7.0 |
|
| 199 | - */ |
|
| 200 | - const TIMEZONE_NAME = 'timeZoneName'; |
|
| 20 | + /** |
|
| 21 | + * @var string address_components |
|
| 22 | + */ |
|
| 23 | + const ADDRESS_COMPONENTS = 'address_components'; |
|
| 24 | + |
|
| 25 | + /** |
|
| 26 | + * @var string formatted_address |
|
| 27 | + */ |
|
| 28 | + const FORMATTED_ADDRESS = 'formatted_address'; |
|
| 29 | + |
|
| 30 | + /** |
|
| 31 | + * @var string geometry |
|
| 32 | + */ |
|
| 33 | + const GEOMETRY = 'geometry'; |
|
| 34 | + |
|
| 35 | + /** |
|
| 36 | + * @var string viewport |
|
| 37 | + */ |
|
| 38 | + const VIEWPORT = 'viewport'; |
|
| 39 | + |
|
| 40 | + /** |
|
| 41 | + * @var string place_id |
|
| 42 | + */ |
|
| 43 | + const PLACE_ID = 'place_id'; |
|
| 44 | + |
|
| 45 | + /** |
|
| 46 | + * @var string location_type |
|
| 47 | + */ |
|
| 48 | + const LOCATION_TYPE = 'location_type'; |
|
| 49 | + |
|
| 50 | + /** |
|
| 51 | + * @var string types |
|
| 52 | + */ |
|
| 53 | + const TYPES = 'types'; |
|
| 54 | + |
|
| 55 | + /** |
|
| 56 | + * @var string location |
|
| 57 | + */ |
|
| 58 | + const LOCATION = 'location'; |
|
| 59 | + |
|
| 60 | + /** |
|
| 61 | + * @var string elevation |
|
| 62 | + */ |
|
| 63 | + const ELEVATION = 'elevation'; |
|
| 64 | + |
|
| 65 | + /** |
|
| 66 | + * @var string resolution |
|
| 67 | + */ |
|
| 68 | + const RESOLUTION = 'resolution'; |
|
| 69 | + |
|
| 70 | + /** |
|
| 71 | + * @var string icon |
|
| 72 | + * @since 0.5.0 |
|
| 73 | + */ |
|
| 74 | + const ICON = 'icon'; |
|
| 75 | + |
|
| 76 | + /** |
|
| 77 | + * @var string id |
|
| 78 | + * @since 0.5.0 |
|
| 79 | + */ |
|
| 80 | + const ID = 'id'; |
|
| 81 | + |
|
| 82 | + /** |
|
| 83 | + * @var string name |
|
| 84 | + * @since 0.5.0 |
|
| 85 | + */ |
|
| 86 | + const NAME = 'name'; |
|
| 87 | + |
|
| 88 | + /** |
|
| 89 | + * @var string photos |
|
| 90 | + * @since 0.5.0 |
|
| 91 | + */ |
|
| 92 | + const PHOTOS = 'photos'; |
|
| 93 | + |
|
| 94 | + /** |
|
| 95 | + * @var string reference |
|
| 96 | + * @since 0.5.0 |
|
| 97 | + */ |
|
| 98 | + const REFERENCE = 'reference'; |
|
| 99 | + |
|
| 100 | + /** |
|
| 101 | + * @var string vicinity |
|
| 102 | + * @since 0.5.0 |
|
| 103 | + */ |
|
| 104 | + const VICINITY = 'vicinity'; |
|
| 105 | + |
|
| 106 | + /** |
|
| 107 | + * @var string opening_hours |
|
| 108 | + * @since 0.5.0 |
|
| 109 | + */ |
|
| 110 | + const OPENING_HOURS = 'opening_hours'; |
|
| 111 | + |
|
| 112 | + /** |
|
| 113 | + * @var string price_level |
|
| 114 | + * @since 0.5.0 |
|
| 115 | + */ |
|
| 116 | + const PRICE_LEVEL = 'price_level'; |
|
| 117 | + |
|
| 118 | + /** |
|
| 119 | + * @var string rating |
|
| 120 | + * @since 0.5.0 |
|
| 121 | + */ |
|
| 122 | + const RATING = 'rating'; |
|
| 123 | + |
|
| 124 | + /** |
|
| 125 | + * @var string permanently_closed |
|
| 126 | + * @since 0.5.0 |
|
| 127 | + */ |
|
| 128 | + const PERMANENTLY_CLOSED = 'permanently_closed'; |
|
| 129 | + |
|
| 130 | + /** |
|
| 131 | + * @var string plus_code |
|
| 132 | + * @since 0.5.0 |
|
| 133 | + */ |
|
| 134 | + const PLUS_CODE = 'plus_code'; |
|
| 135 | + |
|
| 136 | + /** |
|
| 137 | + * @var string next_page_token |
|
| 138 | + * @since 0.5.0 |
|
| 139 | + */ |
|
| 140 | + const NEXT_PAGE_TOKEN = 'next_page_token'; |
|
| 141 | + |
|
| 142 | + /** |
|
| 143 | + * @var string reviews |
|
| 144 | + * @since 0.6.0 |
|
| 145 | + */ |
|
| 146 | + const REVIEWS = 'reviews'; |
|
| 147 | + |
|
| 148 | + /** |
|
| 149 | + * @var string utc_offset |
|
| 150 | + * @since 0.6.0 |
|
| 151 | + */ |
|
| 152 | + const UTC_OFFSET = 'utc_offset'; |
|
| 153 | + |
|
| 154 | + /** |
|
| 155 | + * @var string website |
|
| 156 | + * @since 0.6.0 |
|
| 157 | + */ |
|
| 158 | + const WEBSITE = 'website'; |
|
| 159 | + |
|
| 160 | + /** |
|
| 161 | + * @var string international_phone_number |
|
| 162 | + * @since 0.6.0 |
|
| 163 | + */ |
|
| 164 | + const INTERNATIONAL_PHONE_NUMBER = 'international_phone_number'; |
|
| 165 | + |
|
| 166 | + /** |
|
| 167 | + * @var string formatted_phone_number |
|
| 168 | + * @since 0.6.0 |
|
| 169 | + */ |
|
| 170 | + const FORMATTED_PHONE_NUMBER = 'formatted_phone_number'; |
|
| 171 | + |
|
| 172 | + /** |
|
| 173 | + * @var string adr_address |
|
| 174 | + * @since 0.6.0 |
|
| 175 | + */ |
|
| 176 | + const ADR_ADDRESS = 'adr_address'; |
|
| 177 | + |
|
| 178 | + /** |
|
| 179 | + * @var string dstOffset |
|
| 180 | + * @since 0.7.0 |
|
| 181 | + */ |
|
| 182 | + const DST_OFFSET = 'dstOffset'; |
|
| 183 | + |
|
| 184 | + /** |
|
| 185 | + * @var string rawOffset |
|
| 186 | + * @since 0.7.0 |
|
| 187 | + */ |
|
| 188 | + const RAW_OFFSET = 'rawOffset'; |
|
| 189 | + |
|
| 190 | + /** |
|
| 191 | + * @var string timeZoneId |
|
| 192 | + * @since 0.7.0 |
|
| 193 | + */ |
|
| 194 | + const TIMEZONE_ID = 'timeZoneId'; |
|
| 195 | + |
|
| 196 | + /** |
|
| 197 | + * @var string timeZoneName |
|
| 198 | + * @since 0.7.0 |
|
| 199 | + */ |
|
| 200 | + const TIMEZONE_NAME = 'timeZoneName'; |
|
| 201 | 201 | |
| 202 | 202 | } |
| 203 | 203 | \ No newline at end of file |
@@ -23,343 +23,343 @@ |
||
| 23 | 23 | class GoogleMapsResponse |
| 24 | 24 | { |
| 25 | 25 | |
| 26 | - /** |
|
| 27 | - * @var Response |
|
| 28 | - */ |
|
| 29 | - protected $response = null; |
|
| 30 | - |
|
| 31 | - /** |
|
| 32 | - * Single result |
|
| 33 | - * When the Places service returns results from a details request, it places them within a single result |
|
| 34 | - * |
|
| 35 | - * @var array |
|
| 36 | - * @see https://developers.google.com/places/web-service/details#PlaceDetailsResults |
|
| 37 | - */ |
|
| 38 | - protected $result = null; |
|
| 39 | - |
|
| 40 | - /** |
|
| 41 | - * contains an array of places, with information about each. |
|
| 42 | - * The Places API returns up to 20 establishment results per query. |
|
| 43 | - * Additionally, political results may be returned which serve to identify the area of the request. |
|
| 44 | - * |
|
| 45 | - * @var array |
|
| 46 | - * @see https://developers.google.com/places/web-service/search#PlaceSearchResults |
|
| 47 | - */ |
|
| 48 | - protected $results = null; |
|
| 49 | - |
|
| 50 | - /** |
|
| 51 | - * contains metadata on the request. |
|
| 52 | - * |
|
| 53 | - * @var string |
|
| 54 | - * @see https://developers.google.com/places/web-service/search#PlaceSearchStatusCodes |
|
| 55 | - */ |
|
| 56 | - protected $status = null; |
|
| 57 | - |
|
| 58 | - /** |
|
| 59 | - * @var string |
|
| 60 | - */ |
|
| 61 | - protected $error_message = null; |
|
| 62 | - |
|
| 63 | - /** |
|
| 64 | - * @var array |
|
| 65 | - */ |
|
| 66 | - protected $array_response = null; |
|
| 67 | - |
|
| 68 | - /** |
|
| 69 | - * @var null|array |
|
| 70 | - */ |
|
| 71 | - protected $http_status_code = null; |
|
| 72 | - |
|
| 73 | - /** |
|
| 74 | - * may contain a set of attributions about this listing which must be displayed to the user (some listings may not have attribution). |
|
| 75 | - * |
|
| 76 | - * @var null|array |
|
| 77 | - * @since 0.5.0 |
|
| 78 | - */ |
|
| 79 | - protected $html_attributions = null; |
|
| 80 | - |
|
| 81 | - /** |
|
| 82 | - * @var null|string |
|
| 83 | - * @since 0.5.0 |
|
| 84 | - */ |
|
| 85 | - protected $next_page_token = null; |
|
| 86 | - |
|
| 87 | - /** |
|
| 88 | - * GoogleMapsResponse constructor. |
|
| 89 | - * |
|
| 90 | - * @param Response $response |
|
| 91 | - */ |
|
| 92 | - public function __construct(Response $response) |
|
| 93 | - { |
|
| 94 | - |
|
| 95 | - $this->setResponse($response); |
|
| 96 | - |
|
| 97 | - $this->parseResponse(); |
|
| 98 | - |
|
| 99 | - $this->checkHttpStatusCode(); |
|
| 100 | - } |
|
| 101 | - |
|
| 102 | - /** |
|
| 103 | - * @param Response $response |
|
| 104 | - * |
|
| 105 | - * @return GoogleMapsResponse |
|
| 106 | - */ |
|
| 107 | - public function setResponse(Response $response): GoogleMapsResponse |
|
| 108 | - { |
|
| 109 | - |
|
| 110 | - $this->response = $response; |
|
| 111 | - |
|
| 112 | - return $this; |
|
| 113 | - } |
|
| 114 | - |
|
| 115 | - /** |
|
| 116 | - * @return GoogleMapsResponse |
|
| 117 | - * |
|
| 118 | - * @throws RequestException |
|
| 119 | - * @throws ResponseException |
|
| 120 | - */ |
|
| 121 | - protected function parseResponse(): GoogleMapsResponse |
|
| 122 | - { |
|
| 123 | - |
|
| 124 | - $json_response = $this->response->getBody()->getContents(); |
|
| 125 | - $array_response = $this->toArray($json_response); |
|
| 126 | - $result = null; |
|
| 127 | - $results = null; |
|
| 128 | - |
|
| 129 | - if (empty($array_response[GoogleMapsResponseFields::STATUS])) { |
|
| 130 | - throw new ResponseException('Missing "status" in GoogleMapsApi Response'); |
|
| 131 | - } |
|
| 132 | - $this->setStatus($array_response[GoogleMapsResponseFields::STATUS]); |
|
| 133 | - |
|
| 134 | - if ($this->getStatus() != GoogleMapsResponseStatusValues::OK) { |
|
| 135 | - $error_message = 'Something went wrong'; |
|
| 136 | - if($this->getStatus() === 'INVALID_REQUEST'){ |
|
| 137 | - print_r($array_response);die();} |
|
| 138 | - if (!empty($array_response[GoogleMapsResponseFields::ERROR_MESSAGE])) { |
|
| 139 | - $error_message = $array_response[GoogleMapsResponseFields::ERROR_MESSAGE]; |
|
| 140 | - $this->setErrorMessage($error_message); |
|
| 141 | - } elseif (!empty($array_response[GoogleMapsResponseFields::STATUS])) { |
|
| 142 | - $error_message .= ': ' . $array_response[GoogleMapsResponseFields::STATUS]; |
|
| 143 | - $this->setErrorMessage($error_message); |
|
| 144 | - } |
|
| 145 | - throw new RequestException($error_message); |
|
| 146 | - |
|
| 147 | - } |
|
| 148 | - |
|
| 149 | - if (!empty($array_response[GoogleMapsResponseFields::RESULTS])) { |
|
| 150 | - $results = $array_response[GoogleMapsResponseFields::RESULTS]; |
|
| 151 | - |
|
| 152 | - } elseif (!empty($array_response[GoogleMapsResponseFields::CANDIDATES])) { |
|
| 153 | - $results = $array_response[GoogleMapsResponseFields::CANDIDATES]; |
|
| 154 | - |
|
| 155 | - }elseif (!empty($array_response[GoogleMapsResponseFields::RESULT])) { |
|
| 156 | - $result = $array_response[GoogleMapsResponseFields::RESULT]; |
|
| 157 | - |
|
| 158 | - } else { |
|
| 159 | - $result = $array_response; |
|
| 160 | - } |
|
| 161 | - $this->setResult($result); |
|
| 162 | - $this->setResults($results); |
|
| 163 | - |
|
| 164 | - if (!empty($array_response[GoogleMapsResponseFields::HTML_ATTRIBUTIONS])) { |
|
| 165 | - $this->setHtmlAttributions($array_response[GoogleMapsResponseFields::HTML_ATTRIBUTIONS]); |
|
| 166 | - } |
|
| 167 | - |
|
| 168 | - if (!empty($array_response[GoogleMapsResponseFields::NEXT_PAGE_TOKEN])) { |
|
| 169 | - $this->setNextPageToken($array_response[GoogleMapsResponseFields::NEXT_PAGE_TOKEN]); |
|
| 170 | - } |
|
| 171 | - |
|
| 172 | - return $this; |
|
| 173 | - } |
|
| 174 | - |
|
| 175 | - /** |
|
| 176 | - * @param string $json_response |
|
| 177 | - * |
|
| 178 | - * @return array |
|
| 179 | - */ |
|
| 180 | - public function toArray(string $json_response): array |
|
| 181 | - { |
|
| 182 | - |
|
| 183 | - $this->array_response = json_decode($json_response, true); |
|
| 184 | - |
|
| 185 | - return $this->array_response; |
|
| 186 | - } |
|
| 187 | - |
|
| 188 | - /** |
|
| 189 | - * @return string |
|
| 190 | - */ |
|
| 191 | - public function getStatus(): string |
|
| 192 | - { |
|
| 193 | - |
|
| 194 | - return $this->status; |
|
| 195 | - } |
|
| 196 | - |
|
| 197 | - /** |
|
| 198 | - * @param string $status |
|
| 199 | - * |
|
| 200 | - * @return GoogleMapsResponse |
|
| 201 | - */ |
|
| 202 | - public function setStatus(string $status) |
|
| 203 | - { |
|
| 204 | - |
|
| 205 | - $this->status = $status; |
|
| 206 | - |
|
| 207 | - return $this; |
|
| 208 | - } |
|
| 209 | - |
|
| 210 | - /** |
|
| 211 | - * Check HTTP status code (silent/No exceptions!) |
|
| 212 | - * @return int |
|
| 213 | - */ |
|
| 214 | - protected function checkHttpStatusCode(): int |
|
| 215 | - { |
|
| 216 | - |
|
| 217 | - $this->http_status_code = $this->response->getStatusCode(); |
|
| 218 | - |
|
| 219 | - return $this->http_status_code; |
|
| 220 | - } |
|
| 221 | - |
|
| 222 | - /** |
|
| 223 | - * @return array |
|
| 224 | - */ |
|
| 225 | - public function getResults() |
|
| 226 | - { |
|
| 227 | - |
|
| 228 | - return $this->results; |
|
| 229 | - } |
|
| 230 | - |
|
| 231 | - /** |
|
| 232 | - * @param array $results |
|
| 233 | - * |
|
| 234 | - * @return $this |
|
| 235 | - */ |
|
| 236 | - public function setResults(?array $results) |
|
| 237 | - { |
|
| 238 | - |
|
| 239 | - $this->results = $results; |
|
| 240 | - |
|
| 241 | - return $this; |
|
| 242 | - } |
|
| 243 | - |
|
| 244 | - /** |
|
| 245 | - * @return array |
|
| 246 | - * @since v0.6.0 |
|
| 247 | - */ |
|
| 248 | - public function getResult() |
|
| 249 | - { |
|
| 250 | - |
|
| 251 | - return $this->result; |
|
| 252 | - } |
|
| 253 | - |
|
| 254 | - /** |
|
| 255 | - * @param array $result |
|
| 256 | - * |
|
| 257 | - * @return $this |
|
| 258 | - * @since v0.6.0 |
|
| 259 | - */ |
|
| 260 | - public function setResult(?array $result) |
|
| 261 | - { |
|
| 262 | - |
|
| 263 | - $this->result = $result; |
|
| 264 | - |
|
| 265 | - return $this; |
|
| 266 | - } |
|
| 267 | - |
|
| 268 | - /** |
|
| 269 | - * @return array |
|
| 270 | - */ |
|
| 271 | - public function getArrayResponse(): array |
|
| 272 | - { |
|
| 273 | - |
|
| 274 | - return $this->array_response; |
|
| 275 | - } |
|
| 276 | - |
|
| 277 | - /** |
|
| 278 | - * @param array $array_response |
|
| 279 | - * |
|
| 280 | - * @return GoogleMapsResponse |
|
| 281 | - */ |
|
| 282 | - public function setArrayResponse(array $array_response): GoogleMapsResponse |
|
| 283 | - { |
|
| 284 | - |
|
| 285 | - $this->array_response = $array_response; |
|
| 286 | - |
|
| 287 | - return $this; |
|
| 288 | - } |
|
| 289 | - |
|
| 290 | - /** |
|
| 291 | - * @return mixed |
|
| 292 | - */ |
|
| 293 | - public function getErrorMessage() |
|
| 294 | - { |
|
| 295 | - |
|
| 296 | - return $this->error_message; |
|
| 297 | - } |
|
| 298 | - |
|
| 299 | - /** |
|
| 300 | - * @param $error_message |
|
| 301 | - * |
|
| 302 | - * @return GoogleMapsResponse |
|
| 303 | - */ |
|
| 304 | - public function setErrorMessage($error_message): GoogleMapsResponse |
|
| 305 | - { |
|
| 306 | - |
|
| 307 | - $this->error_message = $error_message; |
|
| 308 | - |
|
| 309 | - return $this; |
|
| 310 | - } |
|
| 311 | - |
|
| 312 | - /** |
|
| 313 | - * @return int |
|
| 314 | - */ |
|
| 315 | - public function getHttpStatusCode(): int |
|
| 316 | - { |
|
| 317 | - |
|
| 318 | - return intval($this->http_status_code); |
|
| 319 | - } |
|
| 320 | - |
|
| 321 | - /** |
|
| 322 | - * @return array|null |
|
| 323 | - */ |
|
| 324 | - public function getHtmlAttributions(): ?array |
|
| 325 | - { |
|
| 326 | - |
|
| 327 | - return $this->html_attributions; |
|
| 328 | - } |
|
| 329 | - |
|
| 330 | - /** |
|
| 331 | - * @param array|null $html_attributions |
|
| 332 | - * |
|
| 333 | - * @return GoogleMapsResponse |
|
| 334 | - */ |
|
| 335 | - public function setHtmlAttributions(?array $html_attributions): GoogleMapsResponse |
|
| 336 | - { |
|
| 337 | - |
|
| 338 | - $this->html_attributions = $html_attributions; |
|
| 339 | - |
|
| 340 | - return $this; |
|
| 341 | - } |
|
| 342 | - |
|
| 343 | - /** |
|
| 344 | - * @return string |
|
| 345 | - */ |
|
| 346 | - public function getNextPageToken(): string |
|
| 347 | - { |
|
| 348 | - |
|
| 349 | - return $this->next_page_token ?? ''; |
|
| 350 | - } |
|
| 351 | - |
|
| 352 | - /** |
|
| 353 | - * @param $next_page_token |
|
| 354 | - * |
|
| 355 | - * @return GoogleMapsResponse |
|
| 356 | - */ |
|
| 357 | - public function setNextPageToken($next_page_token): GoogleMapsResponse |
|
| 358 | - { |
|
| 359 | - |
|
| 360 | - $this->next_page_token = $next_page_token; |
|
| 361 | - |
|
| 362 | - return $this; |
|
| 363 | - } |
|
| 26 | + /** |
|
| 27 | + * @var Response |
|
| 28 | + */ |
|
| 29 | + protected $response = null; |
|
| 30 | + |
|
| 31 | + /** |
|
| 32 | + * Single result |
|
| 33 | + * When the Places service returns results from a details request, it places them within a single result |
|
| 34 | + * |
|
| 35 | + * @var array |
|
| 36 | + * @see https://developers.google.com/places/web-service/details#PlaceDetailsResults |
|
| 37 | + */ |
|
| 38 | + protected $result = null; |
|
| 39 | + |
|
| 40 | + /** |
|
| 41 | + * contains an array of places, with information about each. |
|
| 42 | + * The Places API returns up to 20 establishment results per query. |
|
| 43 | + * Additionally, political results may be returned which serve to identify the area of the request. |
|
| 44 | + * |
|
| 45 | + * @var array |
|
| 46 | + * @see https://developers.google.com/places/web-service/search#PlaceSearchResults |
|
| 47 | + */ |
|
| 48 | + protected $results = null; |
|
| 49 | + |
|
| 50 | + /** |
|
| 51 | + * contains metadata on the request. |
|
| 52 | + * |
|
| 53 | + * @var string |
|
| 54 | + * @see https://developers.google.com/places/web-service/search#PlaceSearchStatusCodes |
|
| 55 | + */ |
|
| 56 | + protected $status = null; |
|
| 57 | + |
|
| 58 | + /** |
|
| 59 | + * @var string |
|
| 60 | + */ |
|
| 61 | + protected $error_message = null; |
|
| 62 | + |
|
| 63 | + /** |
|
| 64 | + * @var array |
|
| 65 | + */ |
|
| 66 | + protected $array_response = null; |
|
| 67 | + |
|
| 68 | + /** |
|
| 69 | + * @var null|array |
|
| 70 | + */ |
|
| 71 | + protected $http_status_code = null; |
|
| 72 | + |
|
| 73 | + /** |
|
| 74 | + * may contain a set of attributions about this listing which must be displayed to the user (some listings may not have attribution). |
|
| 75 | + * |
|
| 76 | + * @var null|array |
|
| 77 | + * @since 0.5.0 |
|
| 78 | + */ |
|
| 79 | + protected $html_attributions = null; |
|
| 80 | + |
|
| 81 | + /** |
|
| 82 | + * @var null|string |
|
| 83 | + * @since 0.5.0 |
|
| 84 | + */ |
|
| 85 | + protected $next_page_token = null; |
|
| 86 | + |
|
| 87 | + /** |
|
| 88 | + * GoogleMapsResponse constructor. |
|
| 89 | + * |
|
| 90 | + * @param Response $response |
|
| 91 | + */ |
|
| 92 | + public function __construct(Response $response) |
|
| 93 | + { |
|
| 94 | + |
|
| 95 | + $this->setResponse($response); |
|
| 96 | + |
|
| 97 | + $this->parseResponse(); |
|
| 98 | + |
|
| 99 | + $this->checkHttpStatusCode(); |
|
| 100 | + } |
|
| 101 | + |
|
| 102 | + /** |
|
| 103 | + * @param Response $response |
|
| 104 | + * |
|
| 105 | + * @return GoogleMapsResponse |
|
| 106 | + */ |
|
| 107 | + public function setResponse(Response $response): GoogleMapsResponse |
|
| 108 | + { |
|
| 109 | + |
|
| 110 | + $this->response = $response; |
|
| 111 | + |
|
| 112 | + return $this; |
|
| 113 | + } |
|
| 114 | + |
|
| 115 | + /** |
|
| 116 | + * @return GoogleMapsResponse |
|
| 117 | + * |
|
| 118 | + * @throws RequestException |
|
| 119 | + * @throws ResponseException |
|
| 120 | + */ |
|
| 121 | + protected function parseResponse(): GoogleMapsResponse |
|
| 122 | + { |
|
| 123 | + |
|
| 124 | + $json_response = $this->response->getBody()->getContents(); |
|
| 125 | + $array_response = $this->toArray($json_response); |
|
| 126 | + $result = null; |
|
| 127 | + $results = null; |
|
| 128 | + |
|
| 129 | + if (empty($array_response[GoogleMapsResponseFields::STATUS])) { |
|
| 130 | + throw new ResponseException('Missing "status" in GoogleMapsApi Response'); |
|
| 131 | + } |
|
| 132 | + $this->setStatus($array_response[GoogleMapsResponseFields::STATUS]); |
|
| 133 | + |
|
| 134 | + if ($this->getStatus() != GoogleMapsResponseStatusValues::OK) { |
|
| 135 | + $error_message = 'Something went wrong'; |
|
| 136 | + if($this->getStatus() === 'INVALID_REQUEST'){ |
|
| 137 | + print_r($array_response);die();} |
|
| 138 | + if (!empty($array_response[GoogleMapsResponseFields::ERROR_MESSAGE])) { |
|
| 139 | + $error_message = $array_response[GoogleMapsResponseFields::ERROR_MESSAGE]; |
|
| 140 | + $this->setErrorMessage($error_message); |
|
| 141 | + } elseif (!empty($array_response[GoogleMapsResponseFields::STATUS])) { |
|
| 142 | + $error_message .= ': ' . $array_response[GoogleMapsResponseFields::STATUS]; |
|
| 143 | + $this->setErrorMessage($error_message); |
|
| 144 | + } |
|
| 145 | + throw new RequestException($error_message); |
|
| 146 | + |
|
| 147 | + } |
|
| 148 | + |
|
| 149 | + if (!empty($array_response[GoogleMapsResponseFields::RESULTS])) { |
|
| 150 | + $results = $array_response[GoogleMapsResponseFields::RESULTS]; |
|
| 151 | + |
|
| 152 | + } elseif (!empty($array_response[GoogleMapsResponseFields::CANDIDATES])) { |
|
| 153 | + $results = $array_response[GoogleMapsResponseFields::CANDIDATES]; |
|
| 154 | + |
|
| 155 | + }elseif (!empty($array_response[GoogleMapsResponseFields::RESULT])) { |
|
| 156 | + $result = $array_response[GoogleMapsResponseFields::RESULT]; |
|
| 157 | + |
|
| 158 | + } else { |
|
| 159 | + $result = $array_response; |
|
| 160 | + } |
|
| 161 | + $this->setResult($result); |
|
| 162 | + $this->setResults($results); |
|
| 163 | + |
|
| 164 | + if (!empty($array_response[GoogleMapsResponseFields::HTML_ATTRIBUTIONS])) { |
|
| 165 | + $this->setHtmlAttributions($array_response[GoogleMapsResponseFields::HTML_ATTRIBUTIONS]); |
|
| 166 | + } |
|
| 167 | + |
|
| 168 | + if (!empty($array_response[GoogleMapsResponseFields::NEXT_PAGE_TOKEN])) { |
|
| 169 | + $this->setNextPageToken($array_response[GoogleMapsResponseFields::NEXT_PAGE_TOKEN]); |
|
| 170 | + } |
|
| 171 | + |
|
| 172 | + return $this; |
|
| 173 | + } |
|
| 174 | + |
|
| 175 | + /** |
|
| 176 | + * @param string $json_response |
|
| 177 | + * |
|
| 178 | + * @return array |
|
| 179 | + */ |
|
| 180 | + public function toArray(string $json_response): array |
|
| 181 | + { |
|
| 182 | + |
|
| 183 | + $this->array_response = json_decode($json_response, true); |
|
| 184 | + |
|
| 185 | + return $this->array_response; |
|
| 186 | + } |
|
| 187 | + |
|
| 188 | + /** |
|
| 189 | + * @return string |
|
| 190 | + */ |
|
| 191 | + public function getStatus(): string |
|
| 192 | + { |
|
| 193 | + |
|
| 194 | + return $this->status; |
|
| 195 | + } |
|
| 196 | + |
|
| 197 | + /** |
|
| 198 | + * @param string $status |
|
| 199 | + * |
|
| 200 | + * @return GoogleMapsResponse |
|
| 201 | + */ |
|
| 202 | + public function setStatus(string $status) |
|
| 203 | + { |
|
| 204 | + |
|
| 205 | + $this->status = $status; |
|
| 206 | + |
|
| 207 | + return $this; |
|
| 208 | + } |
|
| 209 | + |
|
| 210 | + /** |
|
| 211 | + * Check HTTP status code (silent/No exceptions!) |
|
| 212 | + * @return int |
|
| 213 | + */ |
|
| 214 | + protected function checkHttpStatusCode(): int |
|
| 215 | + { |
|
| 216 | + |
|
| 217 | + $this->http_status_code = $this->response->getStatusCode(); |
|
| 218 | + |
|
| 219 | + return $this->http_status_code; |
|
| 220 | + } |
|
| 221 | + |
|
| 222 | + /** |
|
| 223 | + * @return array |
|
| 224 | + */ |
|
| 225 | + public function getResults() |
|
| 226 | + { |
|
| 227 | + |
|
| 228 | + return $this->results; |
|
| 229 | + } |
|
| 230 | + |
|
| 231 | + /** |
|
| 232 | + * @param array $results |
|
| 233 | + * |
|
| 234 | + * @return $this |
|
| 235 | + */ |
|
| 236 | + public function setResults(?array $results) |
|
| 237 | + { |
|
| 238 | + |
|
| 239 | + $this->results = $results; |
|
| 240 | + |
|
| 241 | + return $this; |
|
| 242 | + } |
|
| 243 | + |
|
| 244 | + /** |
|
| 245 | + * @return array |
|
| 246 | + * @since v0.6.0 |
|
| 247 | + */ |
|
| 248 | + public function getResult() |
|
| 249 | + { |
|
| 250 | + |
|
| 251 | + return $this->result; |
|
| 252 | + } |
|
| 253 | + |
|
| 254 | + /** |
|
| 255 | + * @param array $result |
|
| 256 | + * |
|
| 257 | + * @return $this |
|
| 258 | + * @since v0.6.0 |
|
| 259 | + */ |
|
| 260 | + public function setResult(?array $result) |
|
| 261 | + { |
|
| 262 | + |
|
| 263 | + $this->result = $result; |
|
| 264 | + |
|
| 265 | + return $this; |
|
| 266 | + } |
|
| 267 | + |
|
| 268 | + /** |
|
| 269 | + * @return array |
|
| 270 | + */ |
|
| 271 | + public function getArrayResponse(): array |
|
| 272 | + { |
|
| 273 | + |
|
| 274 | + return $this->array_response; |
|
| 275 | + } |
|
| 276 | + |
|
| 277 | + /** |
|
| 278 | + * @param array $array_response |
|
| 279 | + * |
|
| 280 | + * @return GoogleMapsResponse |
|
| 281 | + */ |
|
| 282 | + public function setArrayResponse(array $array_response): GoogleMapsResponse |
|
| 283 | + { |
|
| 284 | + |
|
| 285 | + $this->array_response = $array_response; |
|
| 286 | + |
|
| 287 | + return $this; |
|
| 288 | + } |
|
| 289 | + |
|
| 290 | + /** |
|
| 291 | + * @return mixed |
|
| 292 | + */ |
|
| 293 | + public function getErrorMessage() |
|
| 294 | + { |
|
| 295 | + |
|
| 296 | + return $this->error_message; |
|
| 297 | + } |
|
| 298 | + |
|
| 299 | + /** |
|
| 300 | + * @param $error_message |
|
| 301 | + * |
|
| 302 | + * @return GoogleMapsResponse |
|
| 303 | + */ |
|
| 304 | + public function setErrorMessage($error_message): GoogleMapsResponse |
|
| 305 | + { |
|
| 306 | + |
|
| 307 | + $this->error_message = $error_message; |
|
| 308 | + |
|
| 309 | + return $this; |
|
| 310 | + } |
|
| 311 | + |
|
| 312 | + /** |
|
| 313 | + * @return int |
|
| 314 | + */ |
|
| 315 | + public function getHttpStatusCode(): int |
|
| 316 | + { |
|
| 317 | + |
|
| 318 | + return intval($this->http_status_code); |
|
| 319 | + } |
|
| 320 | + |
|
| 321 | + /** |
|
| 322 | + * @return array|null |
|
| 323 | + */ |
|
| 324 | + public function getHtmlAttributions(): ?array |
|
| 325 | + { |
|
| 326 | + |
|
| 327 | + return $this->html_attributions; |
|
| 328 | + } |
|
| 329 | + |
|
| 330 | + /** |
|
| 331 | + * @param array|null $html_attributions |
|
| 332 | + * |
|
| 333 | + * @return GoogleMapsResponse |
|
| 334 | + */ |
|
| 335 | + public function setHtmlAttributions(?array $html_attributions): GoogleMapsResponse |
|
| 336 | + { |
|
| 337 | + |
|
| 338 | + $this->html_attributions = $html_attributions; |
|
| 339 | + |
|
| 340 | + return $this; |
|
| 341 | + } |
|
| 342 | + |
|
| 343 | + /** |
|
| 344 | + * @return string |
|
| 345 | + */ |
|
| 346 | + public function getNextPageToken(): string |
|
| 347 | + { |
|
| 348 | + |
|
| 349 | + return $this->next_page_token ?? ''; |
|
| 350 | + } |
|
| 351 | + |
|
| 352 | + /** |
|
| 353 | + * @param $next_page_token |
|
| 354 | + * |
|
| 355 | + * @return GoogleMapsResponse |
|
| 356 | + */ |
|
| 357 | + public function setNextPageToken($next_page_token): GoogleMapsResponse |
|
| 358 | + { |
|
| 359 | + |
|
| 360 | + $this->next_page_token = $next_page_token; |
|
| 361 | + |
|
| 362 | + return $this; |
|
| 363 | + } |
|
| 364 | 364 | |
| 365 | 365 | } |
| 366 | 366 | \ No newline at end of file |
@@ -30,45 +30,45 @@ |
||
| 30 | 30 | class TimeZoneResult extends GoogleMapsResult |
| 31 | 31 | { |
| 32 | 32 | |
| 33 | - /** |
|
| 34 | - * @var int |
|
| 35 | - */ |
|
| 36 | - protected $dstOffset = 0; |
|
| 33 | + /** |
|
| 34 | + * @var int |
|
| 35 | + */ |
|
| 36 | + protected $dstOffset = 0; |
|
| 37 | 37 | |
| 38 | - /** |
|
| 39 | - * @var int |
|
| 40 | - */ |
|
| 41 | - protected $rawOffset = 0; |
|
| 38 | + /** |
|
| 39 | + * @var int |
|
| 40 | + */ |
|
| 41 | + protected $rawOffset = 0; |
|
| 42 | 42 | |
| 43 | - /** |
|
| 44 | - * @var string |
|
| 45 | - */ |
|
| 46 | - protected $timeZoneId = ''; |
|
| 43 | + /** |
|
| 44 | + * @var string |
|
| 45 | + */ |
|
| 46 | + protected $timeZoneId = ''; |
|
| 47 | 47 | |
| 48 | - /** |
|
| 49 | - * @var string |
|
| 50 | - */ |
|
| 51 | - protected $timeZoneName = ''; |
|
| 48 | + /** |
|
| 49 | + * @var string |
|
| 50 | + */ |
|
| 51 | + protected $timeZoneName = ''; |
|
| 52 | 52 | |
| 53 | - /** |
|
| 54 | - * @var array |
|
| 55 | - */ |
|
| 56 | - protected $typeCheck = [ |
|
| 57 | - GoogleMapsResultFields::DST_OFFSET => 'int', |
|
| 58 | - GoogleMapsResultFields::RAW_OFFSET => 'int', |
|
| 59 | - GoogleMapsResultFields::TIMEZONE_ID => 'string', |
|
| 60 | - GoogleMapsResultFields::TIMEZONE_NAME => 'string', |
|
| 61 | - ]; |
|
| 53 | + /** |
|
| 54 | + * @var array |
|
| 55 | + */ |
|
| 56 | + protected $typeCheck = [ |
|
| 57 | + GoogleMapsResultFields::DST_OFFSET => 'int', |
|
| 58 | + GoogleMapsResultFields::RAW_OFFSET => 'int', |
|
| 59 | + GoogleMapsResultFields::TIMEZONE_ID => 'string', |
|
| 60 | + GoogleMapsResultFields::TIMEZONE_NAME => 'string', |
|
| 61 | + ]; |
|
| 62 | 62 | |
| 63 | - /** |
|
| 64 | - * @param string $initial_field_name |
|
| 65 | - * |
|
| 66 | - * @return string |
|
| 67 | - */ |
|
| 68 | - protected function getFieldName(string $initial_field_name): string |
|
| 69 | - { |
|
| 63 | + /** |
|
| 64 | + * @param string $initial_field_name |
|
| 65 | + * |
|
| 66 | + * @return string |
|
| 67 | + */ |
|
| 68 | + protected function getFieldName(string $initial_field_name): string |
|
| 69 | + { |
|
| 70 | 70 | |
| 71 | - return lcfirst($initial_field_name); |
|
| 72 | - } |
|
| 71 | + return lcfirst($initial_field_name); |
|
| 72 | + } |
|
| 73 | 73 | |
| 74 | 74 | } |
| 75 | 75 | \ No newline at end of file |
@@ -21,184 +21,184 @@ |
||
| 21 | 21 | abstract class AbstractObject |
| 22 | 22 | { |
| 23 | 23 | |
| 24 | - /** |
|
| 25 | - * @var array |
|
| 26 | - */ |
|
| 27 | - protected $typeCheck = []; |
|
| 28 | - |
|
| 29 | - /** |
|
| 30 | - * @var array |
|
| 31 | - */ |
|
| 32 | - protected $required = []; |
|
| 33 | - |
|
| 34 | - /** |
|
| 35 | - * @var array |
|
| 36 | - */ |
|
| 37 | - protected $errors = []; |
|
| 38 | - |
|
| 39 | - /** |
|
| 40 | - * AbstractObject constructor. |
|
| 41 | - * |
|
| 42 | - * @param array $args |
|
| 43 | - */ |
|
| 44 | - public function __construct(?array $args = []) |
|
| 45 | - { |
|
| 46 | - |
|
| 47 | - if (is_null($args)) { |
|
| 48 | - $args = []; |
|
| 49 | - } |
|
| 50 | - |
|
| 51 | - $this->setArgs($args); |
|
| 52 | - } |
|
| 53 | - |
|
| 54 | - /** |
|
| 55 | - * @param array $args |
|
| 56 | - * |
|
| 57 | - * @throws Exception |
|
| 58 | - */ |
|
| 59 | - protected function setArgs(array $args) |
|
| 60 | - { |
|
| 61 | - |
|
| 62 | - foreach ($this->typeCheck as $field_name => $field_type) { |
|
| 63 | - if (empty($args[$field_name]) || is_null($args[$field_name])) { |
|
| 64 | - if ($this->isFieldRequired($field_name)) { |
|
| 65 | - $this->addError('Missing "' . $field_name . '" in ' . static::class); |
|
| 66 | - } |
|
| 67 | - } else { |
|
| 68 | - $this->$field_name = $this->parseFieldValue($field_type, $args[$field_name]); |
|
| 69 | - } |
|
| 70 | - } |
|
| 71 | - $this->throwErrors(); |
|
| 72 | - } |
|
| 73 | - |
|
| 74 | - /** |
|
| 75 | - * @param string $field_name |
|
| 76 | - * |
|
| 77 | - * @return bool |
|
| 78 | - */ |
|
| 79 | - protected function isFieldRequired(string $field_name): bool |
|
| 80 | - { |
|
| 81 | - |
|
| 82 | - return in_array($field_name, $this->required); |
|
| 83 | - } |
|
| 84 | - |
|
| 85 | - /** |
|
| 86 | - * @param string $error |
|
| 87 | - * |
|
| 88 | - * @return array |
|
| 89 | - */ |
|
| 90 | - protected function addError(string $error): array |
|
| 91 | - { |
|
| 92 | - |
|
| 93 | - array_push($this->errors, $error); |
|
| 94 | - |
|
| 95 | - return $this->errors; |
|
| 96 | - } |
|
| 97 | - |
|
| 98 | - /** |
|
| 99 | - * @param string $field_type |
|
| 100 | - * @param string $field_value |
|
| 101 | - * |
|
| 102 | - * @return mixed |
|
| 103 | - */ |
|
| 104 | - protected function parseFieldValue(string $field_type, $field_value) |
|
| 105 | - { |
|
| 106 | - |
|
| 107 | - switch ($field_type) { |
|
| 108 | - case 'string': |
|
| 109 | - case 'int': |
|
| 110 | - case 'float': |
|
| 111 | - case 'array': |
|
| 112 | - case 'json': |
|
| 113 | - case 'bool': |
|
| 114 | - return $field_value; |
|
| 115 | - default: |
|
| 116 | - return ($field_value instanceof $field_type) ? $field_value : new $field_type($field_value); |
|
| 117 | - } |
|
| 118 | - } |
|
| 119 | - |
|
| 120 | - /** |
|
| 121 | - * @throws Exception |
|
| 122 | - */ |
|
| 123 | - protected function throwErrors() |
|
| 124 | - { |
|
| 125 | - |
|
| 126 | - if (count($this->errors)) { |
|
| 127 | - throw new Exception(implode(', ', $this->errors)); |
|
| 128 | - } |
|
| 129 | - } |
|
| 130 | - |
|
| 131 | - /** |
|
| 132 | - * @return string |
|
| 133 | - */ |
|
| 134 | - public function toJson(): string |
|
| 135 | - { |
|
| 136 | - |
|
| 137 | - return json_encode($this->toArray()); |
|
| 138 | - } |
|
| 139 | - |
|
| 140 | - /** |
|
| 141 | - * @return array |
|
| 142 | - */ |
|
| 143 | - public function toArray(): array |
|
| 144 | - { |
|
| 145 | - |
|
| 146 | - $fields = get_object_vars($this); |
|
| 147 | - |
|
| 148 | - foreach ($fields as $field_name => $field_value) { |
|
| 149 | - |
|
| 150 | - if (!is_scalar($field_value) && method_exists($field_value, 'toJson')) { |
|
| 151 | - $fields[$field_name] = $field_value->toArray(); |
|
| 152 | - } |
|
| 153 | - } |
|
| 154 | - |
|
| 155 | - return $fields; |
|
| 156 | - } |
|
| 157 | - |
|
| 158 | - /** |
|
| 159 | - * @return string |
|
| 160 | - */ |
|
| 161 | - public function __toString(): string |
|
| 162 | - { |
|
| 163 | - |
|
| 164 | - return implode(',', $this->toArray()); |
|
| 165 | - } |
|
| 166 | - |
|
| 167 | - /** |
|
| 168 | - * @param $name |
|
| 169 | - * @param $arguments |
|
| 170 | - * |
|
| 171 | - * @return mixed |
|
| 172 | - */ |
|
| 173 | - public function __call($name, $arguments) |
|
| 174 | - { |
|
| 175 | - |
|
| 176 | - preg_match('/(?<=(g|s)et)([A-Za-z0-9])\w+/', $name, $match); |
|
| 177 | - |
|
| 178 | - $camel_field = (empty($match[0])) ? '' : $match[0]; |
|
| 179 | - |
|
| 180 | - $snake_field = $this->getFieldName($camel_field); |
|
| 181 | - |
|
| 182 | - $field_type = (empty($this->typeCheck[$snake_field])) ? null : $this->typeCheck[$snake_field]; |
|
| 183 | - |
|
| 184 | - if (!empty($match[1]) && $field_type) { |
|
| 185 | - switch ($match[1]) { |
|
| 186 | - case 's': |
|
| 187 | - return $this->$snake_field = $this->parseFieldValue($field_type, current($arguments)); |
|
| 188 | - case 'g': |
|
| 189 | - return $this->$snake_field; |
|
| 190 | - } |
|
| 191 | - } |
|
| 192 | - } |
|
| 193 | - |
|
| 194 | - /** |
|
| 195 | - * @param string $initial_field_name |
|
| 196 | - * |
|
| 197 | - * @return string |
|
| 198 | - */ |
|
| 199 | - protected function getFieldName(string $initial_field_name): string |
|
| 200 | - { |
|
| 201 | - |
|
| 202 | - return camel2Snake($initial_field_name); |
|
| 203 | - } |
|
| 24 | + /** |
|
| 25 | + * @var array |
|
| 26 | + */ |
|
| 27 | + protected $typeCheck = []; |
|
| 28 | + |
|
| 29 | + /** |
|
| 30 | + * @var array |
|
| 31 | + */ |
|
| 32 | + protected $required = []; |
|
| 33 | + |
|
| 34 | + /** |
|
| 35 | + * @var array |
|
| 36 | + */ |
|
| 37 | + protected $errors = []; |
|
| 38 | + |
|
| 39 | + /** |
|
| 40 | + * AbstractObject constructor. |
|
| 41 | + * |
|
| 42 | + * @param array $args |
|
| 43 | + */ |
|
| 44 | + public function __construct(?array $args = []) |
|
| 45 | + { |
|
| 46 | + |
|
| 47 | + if (is_null($args)) { |
|
| 48 | + $args = []; |
|
| 49 | + } |
|
| 50 | + |
|
| 51 | + $this->setArgs($args); |
|
| 52 | + } |
|
| 53 | + |
|
| 54 | + /** |
|
| 55 | + * @param array $args |
|
| 56 | + * |
|
| 57 | + * @throws Exception |
|
| 58 | + */ |
|
| 59 | + protected function setArgs(array $args) |
|
| 60 | + { |
|
| 61 | + |
|
| 62 | + foreach ($this->typeCheck as $field_name => $field_type) { |
|
| 63 | + if (empty($args[$field_name]) || is_null($args[$field_name])) { |
|
| 64 | + if ($this->isFieldRequired($field_name)) { |
|
| 65 | + $this->addError('Missing "' . $field_name . '" in ' . static::class); |
|
| 66 | + } |
|
| 67 | + } else { |
|
| 68 | + $this->$field_name = $this->parseFieldValue($field_type, $args[$field_name]); |
|
| 69 | + } |
|
| 70 | + } |
|
| 71 | + $this->throwErrors(); |
|
| 72 | + } |
|
| 73 | + |
|
| 74 | + /** |
|
| 75 | + * @param string $field_name |
|
| 76 | + * |
|
| 77 | + * @return bool |
|
| 78 | + */ |
|
| 79 | + protected function isFieldRequired(string $field_name): bool |
|
| 80 | + { |
|
| 81 | + |
|
| 82 | + return in_array($field_name, $this->required); |
|
| 83 | + } |
|
| 84 | + |
|
| 85 | + /** |
|
| 86 | + * @param string $error |
|
| 87 | + * |
|
| 88 | + * @return array |
|
| 89 | + */ |
|
| 90 | + protected function addError(string $error): array |
|
| 91 | + { |
|
| 92 | + |
|
| 93 | + array_push($this->errors, $error); |
|
| 94 | + |
|
| 95 | + return $this->errors; |
|
| 96 | + } |
|
| 97 | + |
|
| 98 | + /** |
|
| 99 | + * @param string $field_type |
|
| 100 | + * @param string $field_value |
|
| 101 | + * |
|
| 102 | + * @return mixed |
|
| 103 | + */ |
|
| 104 | + protected function parseFieldValue(string $field_type, $field_value) |
|
| 105 | + { |
|
| 106 | + |
|
| 107 | + switch ($field_type) { |
|
| 108 | + case 'string': |
|
| 109 | + case 'int': |
|
| 110 | + case 'float': |
|
| 111 | + case 'array': |
|
| 112 | + case 'json': |
|
| 113 | + case 'bool': |
|
| 114 | + return $field_value; |
|
| 115 | + default: |
|
| 116 | + return ($field_value instanceof $field_type) ? $field_value : new $field_type($field_value); |
|
| 117 | + } |
|
| 118 | + } |
|
| 119 | + |
|
| 120 | + /** |
|
| 121 | + * @throws Exception |
|
| 122 | + */ |
|
| 123 | + protected function throwErrors() |
|
| 124 | + { |
|
| 125 | + |
|
| 126 | + if (count($this->errors)) { |
|
| 127 | + throw new Exception(implode(', ', $this->errors)); |
|
| 128 | + } |
|
| 129 | + } |
|
| 130 | + |
|
| 131 | + /** |
|
| 132 | + * @return string |
|
| 133 | + */ |
|
| 134 | + public function toJson(): string |
|
| 135 | + { |
|
| 136 | + |
|
| 137 | + return json_encode($this->toArray()); |
|
| 138 | + } |
|
| 139 | + |
|
| 140 | + /** |
|
| 141 | + * @return array |
|
| 142 | + */ |
|
| 143 | + public function toArray(): array |
|
| 144 | + { |
|
| 145 | + |
|
| 146 | + $fields = get_object_vars($this); |
|
| 147 | + |
|
| 148 | + foreach ($fields as $field_name => $field_value) { |
|
| 149 | + |
|
| 150 | + if (!is_scalar($field_value) && method_exists($field_value, 'toJson')) { |
|
| 151 | + $fields[$field_name] = $field_value->toArray(); |
|
| 152 | + } |
|
| 153 | + } |
|
| 154 | + |
|
| 155 | + return $fields; |
|
| 156 | + } |
|
| 157 | + |
|
| 158 | + /** |
|
| 159 | + * @return string |
|
| 160 | + */ |
|
| 161 | + public function __toString(): string |
|
| 162 | + { |
|
| 163 | + |
|
| 164 | + return implode(',', $this->toArray()); |
|
| 165 | + } |
|
| 166 | + |
|
| 167 | + /** |
|
| 168 | + * @param $name |
|
| 169 | + * @param $arguments |
|
| 170 | + * |
|
| 171 | + * @return mixed |
|
| 172 | + */ |
|
| 173 | + public function __call($name, $arguments) |
|
| 174 | + { |
|
| 175 | + |
|
| 176 | + preg_match('/(?<=(g|s)et)([A-Za-z0-9])\w+/', $name, $match); |
|
| 177 | + |
|
| 178 | + $camel_field = (empty($match[0])) ? '' : $match[0]; |
|
| 179 | + |
|
| 180 | + $snake_field = $this->getFieldName($camel_field); |
|
| 181 | + |
|
| 182 | + $field_type = (empty($this->typeCheck[$snake_field])) ? null : $this->typeCheck[$snake_field]; |
|
| 183 | + |
|
| 184 | + if (!empty($match[1]) && $field_type) { |
|
| 185 | + switch ($match[1]) { |
|
| 186 | + case 's': |
|
| 187 | + return $this->$snake_field = $this->parseFieldValue($field_type, current($arguments)); |
|
| 188 | + case 'g': |
|
| 189 | + return $this->$snake_field; |
|
| 190 | + } |
|
| 191 | + } |
|
| 192 | + } |
|
| 193 | + |
|
| 194 | + /** |
|
| 195 | + * @param string $initial_field_name |
|
| 196 | + * |
|
| 197 | + * @return string |
|
| 198 | + */ |
|
| 199 | + protected function getFieldName(string $initial_field_name): string |
|
| 200 | + { |
|
| 201 | + |
|
| 202 | + return camel2Snake($initial_field_name); |
|
| 203 | + } |
|
| 204 | 204 | } |
@@ -27,35 +27,35 @@ |
||
| 27 | 27 | class TimeZone extends Api |
| 28 | 28 | { |
| 29 | 29 | |
| 30 | - /** |
|
| 31 | - * @var string |
|
| 32 | - */ |
|
| 33 | - const SERVICE_ENDPOINT = 'timezone'; |
|
| 34 | - |
|
| 35 | - /** |
|
| 36 | - * @var string |
|
| 37 | - */ |
|
| 38 | - protected $result_type = TimeZoneResult::class; |
|
| 39 | - |
|
| 40 | - /** |
|
| 41 | - * @param Location $location |
|
| 42 | - * @param int $timestamp |
|
| 43 | - * @param string|null $language |
|
| 44 | - * |
|
| 45 | - * @return GoogleMapsResult |
|
| 46 | - */ |
|
| 47 | - public function get(Location $location, int $timestamp, string $language = null): GoogleMapsResult |
|
| 48 | - { |
|
| 49 | - |
|
| 50 | - $params = [ |
|
| 51 | - GoogleMapsRequestFields::LOCATION => $location, |
|
| 52 | - GoogleMapsRequestFields::TIMESTAMP => $timestamp, |
|
| 53 | - ]; |
|
| 54 | - |
|
| 55 | - if ($language) { |
|
| 56 | - $params[GoogleMapsRequestFields::LANGUAGE] = $language; |
|
| 57 | - } |
|
| 58 | - |
|
| 59 | - return $this->callApi($params); |
|
| 60 | - } |
|
| 30 | + /** |
|
| 31 | + * @var string |
|
| 32 | + */ |
|
| 33 | + const SERVICE_ENDPOINT = 'timezone'; |
|
| 34 | + |
|
| 35 | + /** |
|
| 36 | + * @var string |
|
| 37 | + */ |
|
| 38 | + protected $result_type = TimeZoneResult::class; |
|
| 39 | + |
|
| 40 | + /** |
|
| 41 | + * @param Location $location |
|
| 42 | + * @param int $timestamp |
|
| 43 | + * @param string|null $language |
|
| 44 | + * |
|
| 45 | + * @return GoogleMapsResult |
|
| 46 | + */ |
|
| 47 | + public function get(Location $location, int $timestamp, string $language = null): GoogleMapsResult |
|
| 48 | + { |
|
| 49 | + |
|
| 50 | + $params = [ |
|
| 51 | + GoogleMapsRequestFields::LOCATION => $location, |
|
| 52 | + GoogleMapsRequestFields::TIMESTAMP => $timestamp, |
|
| 53 | + ]; |
|
| 54 | + |
|
| 55 | + if ($language) { |
|
| 56 | + $params[GoogleMapsRequestFields::LANGUAGE] = $language; |
|
| 57 | + } |
|
| 58 | + |
|
| 59 | + return $this->callApi($params); |
|
| 60 | + } |
|
| 61 | 61 | } |
@@ -26,112 +26,112 @@ |
||
| 26 | 26 | class Geocoding extends Api |
| 27 | 27 | { |
| 28 | 28 | |
| 29 | - /** |
|
| 30 | - * The language in which to return results |
|
| 31 | - * https://developers.google.com/maps/faq#languagesupport |
|
| 32 | - * |
|
| 33 | - * @var null|string |
|
| 34 | - */ |
|
| 35 | - private $language = null; |
|
| 29 | + /** |
|
| 30 | + * The language in which to return results |
|
| 31 | + * https://developers.google.com/maps/faq#languagesupport |
|
| 32 | + * |
|
| 33 | + * @var null|string |
|
| 34 | + */ |
|
| 35 | + private $language = null; |
|
| 36 | 36 | |
| 37 | - /** |
|
| 38 | - * @var string |
|
| 39 | - */ |
|
| 40 | - const SERVICE_ENDPOINT = 'geocode'; |
|
| 37 | + /** |
|
| 38 | + * @var string |
|
| 39 | + */ |
|
| 40 | + const SERVICE_ENDPOINT = 'geocode'; |
|
| 41 | 41 | |
| 42 | - /** |
|
| 43 | - * @var string |
|
| 44 | - */ |
|
| 45 | - protected $result_collection_type = GeocodingResultsCollection::class; |
|
| 42 | + /** |
|
| 43 | + * @var string |
|
| 44 | + */ |
|
| 45 | + protected $result_collection_type = GeocodingResultsCollection::class; |
|
| 46 | 46 | |
| 47 | - /** |
|
| 48 | - * Set the language in which to return results |
|
| 49 | - * |
|
| 50 | - * @param null|string $language |
|
| 51 | - * @return self |
|
| 52 | - */ |
|
| 53 | - public function setLanguage(?string $language = null): self |
|
| 54 | - { |
|
| 55 | - $this->language = $language; |
|
| 56 | - return $this; |
|
| 57 | - } |
|
| 47 | + /** |
|
| 48 | + * Set the language in which to return results |
|
| 49 | + * |
|
| 50 | + * @param null|string $language |
|
| 51 | + * @return self |
|
| 52 | + */ |
|
| 53 | + public function setLanguage(?string $language = null): self |
|
| 54 | + { |
|
| 55 | + $this->language = $language; |
|
| 56 | + return $this; |
|
| 57 | + } |
|
| 58 | 58 | |
| 59 | - /** |
|
| 60 | - * Add language to $params list if necessary |
|
| 61 | - * |
|
| 62 | - * @param array $params |
|
| 63 | - * @return array |
|
| 64 | - * @since 0.8.0 |
|
| 65 | - */ |
|
| 66 | - public function prepareParams(array $params): array |
|
| 67 | - { |
|
| 68 | - if ($this->language) { |
|
| 69 | - $params[GoogleMapsRequestFields::LANGUAGE] = $this->language; |
|
| 70 | - } |
|
| 71 | - return $params; |
|
| 72 | - } |
|
| 59 | + /** |
|
| 60 | + * Add language to $params list if necessary |
|
| 61 | + * |
|
| 62 | + * @param array $params |
|
| 63 | + * @return array |
|
| 64 | + * @since 0.8.0 |
|
| 65 | + */ |
|
| 66 | + public function prepareParams(array $params): array |
|
| 67 | + { |
|
| 68 | + if ($this->language) { |
|
| 69 | + $params[GoogleMapsRequestFields::LANGUAGE] = $this->language; |
|
| 70 | + } |
|
| 71 | + return $params; |
|
| 72 | + } |
|
| 73 | 73 | |
| 74 | - /** |
|
| 75 | - * Geocoding (Address Lookup) |
|
| 76 | - * |
|
| 77 | - * @param string $literal_address |
|
| 78 | - * @param string $region |
|
| 79 | - * |
|
| 80 | - * @return GoogleMapsResultsCollection |
|
| 81 | - */ |
|
| 82 | - public function getByAddress(string $literal_address, ?string $region = null): GoogleMapsResultsCollection |
|
| 83 | - { |
|
| 84 | - $params = [ |
|
| 85 | - GoogleMapsRequestFields::ADDRESS => $literal_address |
|
| 86 | - ]; |
|
| 87 | - if ($region) { |
|
| 88 | - $params[GoogleMapsRequestFields::REGION] = $region; |
|
| 89 | - } |
|
| 90 | - $params = $this->prepareParams($params); |
|
| 91 | - return $this->callApi($params); |
|
| 92 | - } |
|
| 74 | + /** |
|
| 75 | + * Geocoding (Address Lookup) |
|
| 76 | + * |
|
| 77 | + * @param string $literal_address |
|
| 78 | + * @param string $region |
|
| 79 | + * |
|
| 80 | + * @return GoogleMapsResultsCollection |
|
| 81 | + */ |
|
| 82 | + public function getByAddress(string $literal_address, ?string $region = null): GoogleMapsResultsCollection |
|
| 83 | + { |
|
| 84 | + $params = [ |
|
| 85 | + GoogleMapsRequestFields::ADDRESS => $literal_address |
|
| 86 | + ]; |
|
| 87 | + if ($region) { |
|
| 88 | + $params[GoogleMapsRequestFields::REGION] = $region; |
|
| 89 | + } |
|
| 90 | + $params = $this->prepareParams($params); |
|
| 91 | + return $this->callApi($params); |
|
| 92 | + } |
|
| 93 | 93 | |
| 94 | - /** |
|
| 95 | - * ALIAS: getByLatLng |
|
| 96 | - * Geocoding (Latitude/Longitude Lookup) |
|
| 97 | - * |
|
| 98 | - * @param LatLng $latlng |
|
| 99 | - * |
|
| 100 | - * @return GoogleMapsResultsCollection |
|
| 101 | - * @deprecated 0.8.0 |
|
| 102 | - */ |
|
| 103 | - public function getReverse(LatLng $latlng): GoogleMapsResultsCollection |
|
| 104 | - { |
|
| 105 | - return $this->getByLatLng($latlng); |
|
| 106 | - } |
|
| 94 | + /** |
|
| 95 | + * ALIAS: getByLatLng |
|
| 96 | + * Geocoding (Latitude/Longitude Lookup) |
|
| 97 | + * |
|
| 98 | + * @param LatLng $latlng |
|
| 99 | + * |
|
| 100 | + * @return GoogleMapsResultsCollection |
|
| 101 | + * @deprecated 0.8.0 |
|
| 102 | + */ |
|
| 103 | + public function getReverse(LatLng $latlng): GoogleMapsResultsCollection |
|
| 104 | + { |
|
| 105 | + return $this->getByLatLng($latlng); |
|
| 106 | + } |
|
| 107 | 107 | |
| 108 | - /** |
|
| 109 | - * Geocoding (Latitude/Longitude Lookup) |
|
| 110 | - * |
|
| 111 | - * @param LatLng $latlng |
|
| 112 | - * |
|
| 113 | - * @return GoogleMapsResultsCollection |
|
| 114 | - * @since 0.8.0 |
|
| 115 | - */ |
|
| 116 | - public function getByLatLng(LatLng $latlng): GoogleMapsResultsCollection |
|
| 117 | - { |
|
| 118 | - $params = $this->prepareParams([ |
|
| 119 | - GoogleMapsRequestFields::LATLNG => $latlng |
|
| 120 | - ]); |
|
| 121 | - return $this->callApi($params); |
|
| 122 | - } |
|
| 108 | + /** |
|
| 109 | + * Geocoding (Latitude/Longitude Lookup) |
|
| 110 | + * |
|
| 111 | + * @param LatLng $latlng |
|
| 112 | + * |
|
| 113 | + * @return GoogleMapsResultsCollection |
|
| 114 | + * @since 0.8.0 |
|
| 115 | + */ |
|
| 116 | + public function getByLatLng(LatLng $latlng): GoogleMapsResultsCollection |
|
| 117 | + { |
|
| 118 | + $params = $this->prepareParams([ |
|
| 119 | + GoogleMapsRequestFields::LATLNG => $latlng |
|
| 120 | + ]); |
|
| 121 | + return $this->callApi($params); |
|
| 122 | + } |
|
| 123 | 123 | |
| 124 | - /** |
|
| 125 | - * Retrieving an Address for a Place ID |
|
| 126 | - * |
|
| 127 | - * @param string $place_id |
|
| 128 | - * |
|
| 129 | - * @return GoogleMapsResultsCollection |
|
| 130 | - */ |
|
| 131 | - public function getByPlaceId(string $place_id): GoogleMapsResultsCollection |
|
| 132 | - { |
|
| 133 | - return $this->callApi([ |
|
| 134 | - GoogleMapsRequestFields::PLACE_ID => $place_id |
|
| 135 | - ]); |
|
| 136 | - } |
|
| 124 | + /** |
|
| 125 | + * Retrieving an Address for a Place ID |
|
| 126 | + * |
|
| 127 | + * @param string $place_id |
|
| 128 | + * |
|
| 129 | + * @return GoogleMapsResultsCollection |
|
| 130 | + */ |
|
| 131 | + public function getByPlaceId(string $place_id): GoogleMapsResultsCollection |
|
| 132 | + { |
|
| 133 | + return $this->callApi([ |
|
| 134 | + GoogleMapsRequestFields::PLACE_ID => $place_id |
|
| 135 | + ]); |
|
| 136 | + } |
|
| 137 | 137 | } |