Google Street View-integratie in GeoWeb

In de GeoWeb WebViewer is het mogelijk om Google Street View-foto’s te openen via het rechtermuisknopmenu. Daarnaast kunnen Google Street View-foto’s ook worden geïntegreerd in de objectbeschrijving. Dit is bijvoorbeeld handig als je een kaartlaag hebt met adressen, zoals de BAG-adressen. Dit artikel beschrijft hoe deze integratie gerealiseerd kan worden. 

Opmerking: Google heeft onlangs de eisen voor het gebruik van Google Street View aangescherpt waardoor het gebruik van een Google API key noodzakelijk is om Google Street View-foto’s te benaderen. Het aanvragen van een Google API key kan via https://developers.google.com/maps/documentation/streetview/get-api-key. 

A.1 Integratie van Google Street View-foto’s in het rechtermuisknopmenu
Voor het openen van Google Street View-foto’s via het rechtermuisknopmenu dien je de volgende stappen te volgen:

Configuratiestappen

1.Ontzip het bestand GoogleStreetView.zip [ZIP] naar een willekeurige locatie op de GeoWeb-server. 2. Kopieer het bestand ‘GoogleMaps.html’ naar de ‘3rdPartyMaps’ folder in de IIS Virtual Directory van de WebViewer (C:\inetpub\wwwroot\\Resources\3rdPartyMaps).
3. Open het bestand in een teksteditor en voeg de Google API key toe op regel 10.
Voorbeeld:

4. Controleer of de toegang tot de Google Maps JavaScript API geactiveerd is via https://console.developers.google.com/apis/dashboard.

5. Maak een veiligheidskopie aan van het viewer configuratiebestand (bijvoorbeeld ‘Desktop.json.js’ voor de desktop viewer). Dit bestand bevindt zich standaard op C:\Program Files (x86)\Latitude Geographics\Geocortex Essentials\\REST Elements\Sites\\Viewers\\VirtualDirectory\Resources\Config\Default
6. Open het originele viewer configuratiebestand.
7. Zoek naar “externalComponents”.
8. Voeg het volgende toe aan deze module:

{
"id": "googleMaps",
"displayName": "Google Street View",
"uri": "Resources/3rdPartyMaps/GoogleMaps.html",
"viewpointIndicatorUri": "Resources/Images/Icons/location-direction- blue-32.png"
}

Voorbeeld:

9. Zoek vervolgens naar "id": "MapContextMenu".
10. Voeg het volgende toe aan het einde van deze ‘MapContextMenu’ module.

{
"iconUri": "Resources/Images/Icons/center-map-24.png",
"text": "Open hier Google Street View",
"batch": [
{
"command": "PanToPoint",
"commandParameter": "{{context}}"
},
{
"command": "RunWorkflowById",
"commandParameter": "OpenHierStreetView"
}
]
}

Voorbeeld:

11. Sla het bestand op.

Toevoegen OpenStreetView-workflow

1. Ontzip het bestand Rechtermuis.zip [ZIP] naar een willekeurige locatie op de GeoWeb-server.
2. Kopieer het bestand ‘OpenStreetView.xaml’ naar een folder op de Site directory, bijv. in de ‘Resources’ folder. Deze staat standaard op C:\Program Files (x86)\Latitude Geographics\Geocortex Essentials\\REST Elements\Sites.
3. Open vervolgens de betreffende GeoWeb-site in de GeoWeb Manager.
4. Ga naar het Workflows-tabblad en klik op ‘Add Workflow’.
5. Vul de tekst ‘OpenStreetView’ in bij ‘Display Name’.
6. Klik op de Browse-knop.
7. Klik op de map ‘Resources’, kies het workflow bestand ‘OpenStreetView.xaml’ en klik vervolgens op ‘OK’. Het scherm ziet er dan als volgt uit:

8. Klik op ‘Next’ en vervolgens op ‘Finish’.
9. Open nu de viewer (bijv. via Viewers in de GeoWeb Manager).
10. Klik met de rechtermuisknop op een locatie. De Google Street View-foto opent nu onder in het scherm.

A.2 Integratie van Google Street View-foto’s in de objectbeschrijving
Het is ook mogelijk om Google Street View-foto’s te integreren in de objectbeschrijving. Bij een bevraging in de viewer worden deze dan getoond als onderdeel van de objectinformatie. 

Voorbeeld:

Een voorwaarde voor het integreren van de foto’s in de objectbeschrijving is dat de betreffende kaartlaag attribuutvelden bevat met adresgegevens, bijvoorbeeld {Straat} {Huisnummer} en {Plaats}. 

Om de foto te integreren dien je de volgende stappen te volgen: 

1. Open de betreffende GeoWeb-site in de Manager.
2. Ga naar het Map-tabblad.
3. Klik op ‘Edit layer’ achter de kaartlaag waaraan je de Google Street View-foto’s wilt toevoegen.
4. Voeg het volgende toe aan de ‘Feature Long Description’ waarbij de tekst tussen accolades de adresvelden zijn en ‘key’ de Google API key is: <img src="https://maps.googleapis.com/maps/api/streetview?size=200x133&location={Straat} {Huisnummer} {Huisletter} {Huisnummertoevoeging},{Plaats}&fov=90&pitch=-10&sensor=false&key=#######" style="font-size: 10pt;"/>  
5. Bij het bevragen van de objecten uit deze kaartlaag wordt nu de Google Street View-foto geopend in de objectbeschrijving.

Beperkingen aan het gebruik: 
Google heeft onlangs de eisen voor het gebruik van Google Street View aangescherpt waardoor het gebruik van een Google API key noodzakelijk is om Google Street View foto’s te benaderen. Het aanvragen van een Google API key kan via developers.google.com/maps/documentation/streetview/get-api-key.
Let op: Het gebruik van Google Streetview binnen de eigen applicatie via de Google API is niet in alle gevallen toegestaan of gratis. Er zijn beperkingen en/of kosten aan verbonden. Voor de meest actuele versie van de complete voorwaarden raadpleeg deze site: developers.google.com/maps/terms. Vooral artikel 10.4 sectie C beschrijft de aangescherpte gebruiksvoorwaarden van Google. Lees deze goed door! 
In het geval u twijfelt over de toepassing van deze voorwaarden binnen uw organisatie kunt u er altijd voor kiezen om Google Streetview in een apart venster binnen uw browser te openen. Hier zijn geen beperkingen aan verbonden.