1 | <?php |
||
23 | final class AddressBuilder |
||
24 | { |
||
25 | /** |
||
26 | * @var string |
||
27 | */ |
||
28 | private $providedBy; |
||
29 | |||
30 | /** |
||
31 | * @var Coordinates|null |
||
32 | */ |
||
33 | private $coordinates; |
||
34 | |||
35 | /** |
||
36 | * @var Bounds|null |
||
37 | */ |
||
38 | private $bounds; |
||
39 | |||
40 | /** |
||
41 | * @var string|null |
||
42 | */ |
||
43 | private $streetNumber; |
||
44 | |||
45 | /** |
||
46 | * @var string|null |
||
47 | */ |
||
48 | private $streetName; |
||
49 | |||
50 | /** |
||
51 | * @var string|null |
||
52 | */ |
||
53 | private $locality; |
||
54 | |||
55 | /** |
||
56 | * @var string|null |
||
57 | */ |
||
58 | private $postalCode; |
||
59 | |||
60 | /** |
||
61 | * @var string|null |
||
62 | */ |
||
63 | private $subLocality; |
||
64 | |||
65 | /** |
||
66 | * @var array |
||
67 | */ |
||
68 | private $adminLevels = []; |
||
69 | |||
70 | /** |
||
71 | * @var string|null |
||
72 | */ |
||
73 | private $country; |
||
74 | |||
75 | /** |
||
76 | * @var string|null |
||
77 | */ |
||
78 | private $countryCode; |
||
79 | |||
80 | /** |
||
81 | * @var string|null |
||
82 | */ |
||
83 | private $timezone; |
||
84 | |||
85 | /** |
||
86 | * A storage for extra parameters. |
||
87 | * |
||
88 | * @var array |
||
89 | */ |
||
90 | private $data = []; |
||
91 | |||
92 | /** |
||
93 | * @param string $providedBy |
||
94 | */ |
||
95 | public function __construct(string $providedBy) |
||
99 | |||
100 | /** |
||
101 | * @param string $class |
||
102 | * |
||
103 | * @return Address |
||
104 | */ |
||
105 | public function build(string $class = Address::class): Address |
||
106 | { |
||
107 | if (!is_a($class, Address::class, true)) { |
||
108 | throw new LogicException('First parameter to LocationBuilder::build must be a class name extending Geocoder\Model\Address'); |
||
109 | } |
||
110 | |||
111 | $country = null; |
||
112 | if ((null !== $this->country && '' !== $this->country) || (null !== $this->countryCode && '' !== $this->countryCode)) { |
||
113 | $country = new Country($this->country, $this->countryCode); |
||
114 | } |
||
115 | |||
116 | return new $class( |
||
117 | $this->providedBy, |
||
118 | new AdminLevelCollection($this->adminLevels), |
||
119 | $this->coordinates, |
||
120 | $this->bounds, |
||
121 | $this->streetNumber, |
||
122 | $this->streetName, |
||
123 | $this->postalCode, |
||
124 | $this->locality, |
||
125 | $this->subLocality, |
||
126 | $country, |
||
127 | $this->timezone |
||
128 | ); |
||
129 | } |
||
130 | |||
131 | /** |
||
132 | * @param float $south |
||
133 | * @param float $west |
||
134 | * @param float $north |
||
135 | * @param float $east |
||
136 | * |
||
137 | * @return AddressBuilder |
||
138 | */ |
||
139 | public function setBounds($south, $west, $north, $east): self |
||
149 | |||
150 | /** |
||
151 | * @param float $latitude |
||
152 | * @param float $longitude |
||
153 | * |
||
154 | * @return AddressBuilder |
||
155 | */ |
||
156 | public function setCoordinates($latitude, $longitude): self |
||
166 | |||
167 | /** |
||
168 | * @param int $level |
||
169 | * @param string $name |
||
170 | * @param string|null $code |
||
171 | * |
||
172 | * @return AddressBuilder |
||
173 | */ |
||
174 | public function addAdminLevel(int $level, string $name, string $code = null): self |
||
180 | |||
181 | /** |
||
182 | * @param string|null $streetNumber |
||
183 | * |
||
184 | * @return AddressBuilder |
||
185 | */ |
||
186 | public function setStreetNumber($streetNumber): self |
||
192 | |||
193 | /** |
||
194 | * @param string|null $streetName |
||
195 | * |
||
196 | * @return AddressBuilder |
||
197 | */ |
||
198 | public function setStreetName($streetName): self |
||
204 | |||
205 | /** |
||
206 | * @param string|null $locality |
||
207 | * |
||
208 | * @return AddressBuilder |
||
209 | */ |
||
210 | public function setLocality($locality): self |
||
216 | |||
217 | /** |
||
218 | * @param string|null $postalCode |
||
219 | * |
||
220 | * @return AddressBuilder |
||
221 | */ |
||
222 | public function setPostalCode($postalCode): self |
||
228 | |||
229 | /** |
||
230 | * @param string|null $subLocality |
||
231 | * |
||
232 | * @return AddressBuilder |
||
233 | */ |
||
234 | public function setSubLocality($subLocality): self |
||
240 | |||
241 | /** |
||
242 | * @param array $adminLevels |
||
243 | * |
||
244 | * @return AddressBuilder |
||
245 | */ |
||
246 | public function setAdminLevels($adminLevels): self |
||
252 | |||
253 | /** |
||
254 | * @param string|null $country |
||
255 | * |
||
256 | * @return AddressBuilder |
||
257 | */ |
||
258 | public function setCountry($country): self |
||
264 | |||
265 | /** |
||
266 | * @param string|null $countryCode |
||
267 | * |
||
268 | * @return AddressBuilder |
||
269 | */ |
||
270 | public function setCountryCode($countryCode): self |
||
276 | |||
277 | /** |
||
278 | * @param string|null $timezone |
||
279 | * |
||
280 | * @return AddressBuilder |
||
281 | */ |
||
282 | public function setTimezone($timezone): self |
||
288 | |||
289 | /** |
||
290 | * @param string $name |
||
291 | * @param mixed $value |
||
292 | * |
||
293 | * @return AddressBuilder |
||
294 | */ |
||
295 | public function setValue(string $name, $value): self |
||
301 | |||
302 | /** |
||
303 | * @param string $name |
||
304 | * @param mixed|null $default |
||
305 | * |
||
306 | * @return mixed |
||
307 | */ |
||
308 | public function getValue(string $name, $default = null) |
||
316 | |||
317 | /** |
||
318 | * @param string $name |
||
319 | * |
||
320 | * @return bool |
||
321 | */ |
||
322 | public function hasValue(string $name): bool |
||
326 | } |
||
327 |