Zastosowanie
API usługi
GoogleMaps
Niniejsza konfiguracja wstępna zostanie wywołana przy założeniu nowego obiektu (np. przy pomocy opcji
"Nowy obiekt ..." w menu kontekstowym obiektu lub naciśnięciem klawisza
Insert po zaznaczeniu obiektu).
Niniejsza konfiguracja wstępna jest przyszeregowana w grupie
"/ Technologia / Mapy".
Taką konfigurację wstępną można wytworzyć w obiekcie
PmaFolder,
PmaRoot lub
PmaPrototype.
Chodzi o przykład aplikacji, która przy pomocy strony HTML wyświetla mapę z aktywnymi punktami zawierającymi odniesienia
do paneli aplikacji.
Przykład został przygotowany jak dla aplikacji lokalnej tak również Webowej.
W celu poprawnego działania aplikacji należy komputer, na którym jest użytkowana aplikacja podłączyć do Internetu.
Konfiguracja wstępna wytworzy zkonfigurowany obiekt typu
PmaFolder z podobiektami
PmaPanel o nazwie "
City", o nazwie "
MapPanel" i o nazwie "
Promotic". Panel
MapPanel zawiera podobiekt
PmaWebDir o nazwie "
Map".
Podobiekt
PmaWebDir o nazwie "
Map" ma utworzoną w zdarzeniu
onPageModify stronę HTML. Zawartość tej strony HTML została wytworzona w taki sposób, że korzysta z
API usługi
GoogleMaps do wyświetlenia wyświetlenia mapy. Na niej mogą znajdować się w określonych pozycjach aktywne punkty s opisem oraz odniesieniem do danego adresu URL. patrz
Google Maps API dokumentacja tworzenia aktywnych punktów "Markers".
Dokonując zmiany zawartości tej strony można zmienić ustawienie domyślne środka mapy (
center:), jej początkowy rozmiar (
zoom:) lub typ mapy (
mapTypeId:)
Dalej znajdują się 4 aktywne
markery (punkty), które zawierają pozycję (
position:), ich opis (
label:) oraz linki do Web paneli aplikacji wywoane w zdarzeniach
click
Pierwsze trzy markery otwierają identyczną stronę (
panelcity), której przekazują w parametrze
city swoją wartość. Panel ten jest skonfigurowany tak, by potrafił parametr ten w swojej zawartości wykorzystać.
Czwarty marker otwiera samodzielny panel
promotic.
W zdarzeniu
onPageAction znajduje się skrypt, który umożliwia w aplikacji lokalnej otworzyć wymaganą stronę z użytym parametrem.
Do nieograniczonego korzystania z usługi google konieczne jest wykupienie licencji i użycie uzyskanego klucza licencyjnego w zmiennej
sGoogleKey na początku tworzenia strony HTML.
Patrz
https://developers.google.com/maps/documentation/embed/get-api-key#creating-api-keys
Konfiguratory, które można ustawić przed wytworzeniem konfiguracji wstępnej:
| Nazwa wytwarzanego obiektu | Nazwa nowo wytworzonego obiektu w drzewie Pma obiektów.
Maksymalna długość nazwy wynosi 30 znaków.
Jest to nazwa systemowa, może zawierać tylko znaki alfanumeryczne oraz nie może zawierać znaki diakrytyczne (tzn. narodowo zależne znaki), pusty łańcuch, spacje oraz pierwszy znak nie może być liczba.
Domyślnie: "GoogleMaps" |
|---|
|
Konfiguracja wstępna wymaga wsparcia dla Microsoft Edge WebView2 Runtime.
A w pliku INI aplikacji jest konieczne wprowadzenie klucza WebView2=1 w sekcji [Promotic]. | |
|---|
| PmaWeb obiekt | Ścieżka w drzewie Pma obiektów do obiektu PmaWeb, PmaWebFolder lub PmaWebLang, do którego wykona się rejestracja.
Do wprowadzenia można zastosować Makro wyrażenie (wartość jest obliczana po uruchomieniu aplikacji).
Po wytworzeniu konfiguracji wstępnej konfigurator "PmaPanel > Web serwer > PmaWeb obiekt" zostanie ustawiony na daną wartość. |
|---|