Added ability to set custom icon URLs

Author: bensquire

examples/example3.php

@@ -12,7 +12,7 @@
 $marker->setSize('mid');
 $marker->setLongitude(-0.062004);
 $marker->setLatitude(51.462564);
-$marker->setLabel('b');
+$marker->setLabel('D');
 
 $map = new \GoogleStaticMap\Map();
 $map->setCenter('London,UK');

examples/example4.php

@@ -8,11 +8,9 @@
  */
 
 $marker = new \GoogleStaticMap\Marker();
-$marker->setColor('blue');
-$marker->setSize('mid');
 $marker->setLongitude(-0.062004);
 $marker->setLatitude(51.462564);
-$marker->setLabel('C');
+$marker->setIconUrl('https://goo.gl/5y3S82');
 
 $marker2 = new \GoogleStaticMap\Marker();
 $marker2->setColor('red');

src/GoogleStaticMap/Marker.php

@@ -17,13 +17,40 @@ class Marker
 {
     public const SEPARATOR = '|';
 
+    /**
+     * @var array
+     */
     protected $validMarkerSizes = ['tiny', 'mid', 'small'];
+
+    /**
+     * @var string
+     */
     protected $longitude = '';
+
+    /**
+     * @var string
+     */
     protected $latitude = '';
+
+    /**
+     * @var string
+     */
     protected $label = '';
+
+    /**
+     * @var string
+     */
     protected $colour = '';
+
+    /**
+     * @var string
+     */
     protected $size = '';
-    protected $customIcon = ''; //TODO implement
+
+    /**
+     * @var ?string
+     */
+    protected $customIcon = null;
 
     /**
      * Output the marker url string
@@ -98,6 +125,16 @@ public function setSize(string $size)
         return $this;
     }
 
+    /**
+     * @param string $url
+     * @return Marker
+     */
+    public function setIconUrl(string $url)
+    {
+        $this->customIcon = $url;
+        return $this;
+    }
+
     /**
      * Return the marker longitude
      *
@@ -148,6 +185,13 @@ public function getSize(): string
         return $this->size;
     }
 
+    /**
+     * @return null|string
+     */
+    public function getIconUrl(): ?string
+    {
+        return $this->customIcon;
+    }
     /**
      * Return the marker url string
      *
@@ -156,6 +200,7 @@ public function getSize(): string
     public function build(): string
     {
         return 'markers=' .
+            ((!empty($this->customIcon)) ? 'icon:' . urlencode($this->customIcon . $this::SEPARATOR) : '') .
             ((!empty($this->colour)) ? 'color:' . urlencode($this->colour . $this::SEPARATOR) : '') .
             ((!empty($this->label)) ? 'label:' . urlencode($this->label . $this::SEPARATOR) : '') .
             ((!empty($this->size)) ? 'size:' . urlencode($this->size . $this::SEPARATOR) : '') .