Update x-apple-structured-location documentation (#236)

markuspoerschke · Apr 4, 2021 · 7f97f19 · 7f97f19
1 parent 7b75916
commit 7f97f19
Show file tree

Hide file tree

Showing 3 changed files with 44 additions and 37 deletions.
diff --git a/docs/advanced/maturity-matrix.md b/docs/advanced/maturity-matrix.md
@@ -36,40 +36,41 @@ See [RFC 5545 section 3.6](https://tools.ietf.org/html/rfc5545#section-3.6).
 
 See [RFC 5545 section 3.6.1](https://tools.ietf.org/html/rfc5545#section-3.6.1).
 
-| Property    | Supported |
-| ----------- | :-------: |
-| dtstamp     |     ✔     |
-| uid         |     ✔     |
-| dtstart     |     ✔     |
-| class       |     ✖     |
-| created     |     ✖     |
-| description |     ✔     |
-| geo         |     ✔     |
-| last-mod    |     ✖     |
-| location    |     ✔     |
-| organizer   |     ✖     |
-| priority    |     ✖     |
-| seq         |     ✖     |
-| status      |     ✖     |
-| summary     |     ✔     |
-| transp      |     ✖     |
-| url         |     ✖     |
-| recurid     |     ✖     |
-| rrule       |     ✖     |
-| dtend       |     ✔     |
-| duration    |     ✖     |
-| attach      |     ✔     |
-| attendee    |     ✖     |
-| categories  |     ✖     |
-| comment     |     ✖     |
-| contact     |     ✖     |
-| exdate      |     ✖     |
-| rstatus     |     ✖     |
-| related     |     ✖     |
-| resources   |     ✖     |
-| rdate       |     ✖     |
-| x-prop      |    (✔)    |
-| iana-prop   |    (✔)    |
+| Property                    | Supported |
+| --------------------------- | :-------: |
+| dtstamp                     |     ✔     |
+| uid                         |     ✔     |
+| dtstart                     |     ✔     |
+| class                       |     ✖     |
+| created                     |     ✖     |
+| description                 |     ✔     |
+| geo                         |     ✔     |
+| last-mod                    |     ✖     |
+| location                    |     ✔     |
+| organizer                   |     ✖     |
+| priority                    |     ✖     |
+| seq                         |     ✖     |
+| status                      |     ✖     |
+| summary                     |     ✔     |
+| transp                      |     ✖     |
+| url                         |     ✖     |
+| recurid                     |     ✖     |
+| rrule                       |     ✖     |
+| dtend                       |     ✔     |
+| duration                    |     ✖     |
+| attach                      |     ✔     |
+| attendee                    |     ✖     |
+| categories                  |     ✖     |
+| comment                     |     ✖     |
+| contact                     |     ✖     |
+| exdate                      |     ✖     |
+| rstatus                     |     ✖     |
+| related                     |     ✖     |
+| resources                   |     ✖     |
+| rdate                       |     ✖     |
+| x-prop                      |    (✔)    |
+| iana-prop                   |    (✔)    |
+| x-apple-structured-location |     ✔     |
 
 ## Alarm Component
 

diff --git a/docs/components/event.md b/docs/components/event.md
@@ -200,13 +200,13 @@ use Eluceo\iCal\Domain\Entity\Event;
 use Eluceo\iCal\Domain\ValueObject\Location;
 use Eluceo\iCal\Domain\ValueObject\GeographicPosition;
 
-$location = new Location('North Pole');
+$location = new Location('Neuschwansteinstraße 20, 87645 Schwangau');
 
 // optionally you can create a location with a title for X-APPLE-STRUCTURED-LOCATION attribute
-$location = new Location('North Pole', 'Middle of nowhere');
+$location = new Location('Neuschwansteinstraße 20, 87645 Schwangau', 'Schloss Neuschwanstein');
 
 // optionally a location with a geographical position can be created
-$location = $location->withGeographicPosition(new GeographicPosition(64.751111, 147.349444));
+$location = $location->withGeographicPosition(new GeographicPosition(47.557579, 10.749704));
 
 $event = new Event();
 $event->setLocation($location);

diff --git a/examples/example1.php b/examples/example1.php
@@ -18,6 +18,8 @@
 use Eluceo\iCal\Domain\ValueObject\Alarm;
 use Eluceo\iCal\Domain\ValueObject\Attachment;
 use Eluceo\iCal\Domain\ValueObject\DateTime;
+use Eluceo\iCal\Domain\ValueObject\GeographicPosition;
+use Eluceo\iCal\Domain\ValueObject\Location;
 use Eluceo\iCal\Domain\ValueObject\TimeSpan;
 use Eluceo\iCal\Domain\ValueObject\Uri;
 use Eluceo\iCal\Presentation\Factory\CalendarFactory;
@@ -29,6 +31,10 @@
 $event
     ->setSummary('Christmas Eve')
     ->setDescription('Lorem Ipsum Dolor...')
+    ->setLocation(
+        (new Location('Neuschwansteinstraße 20, 87645 Schwangau', 'Schloss Neuschwanstein'))
+            ->withGeographicPosition(new GeographicPosition(47.557579, 10.749704))
+    )
     ->setOccurrence(
         new TimeSpan(
             new DateTime(DateTimeImmutable::createFromFormat('Y-m-d H:i:s', '2030-12-24 13:30:00'), true),