Google
[ class tree: Google ] [ index: Google ] [ all elements ]
Packages:
Atom-RSS
Gd
GdControler
Google
Html
Sql
Tools


Files:
VgtGoogleMap.php

Classes:
VgtGoogleMap

Class: VgtGoogleMap

Source Location: /_class/VgtGoogleMap.php

Class Overview




obsluga wyswietlania map google'a




Author(s):


    
          
  • VGT
    • 
                        





        
          
      

Version:


    
  
  • 1.4
    • 




Copyright:


    
  
  • Copyright (c) 2007-2008, Tomek Gubala (http://www.vgtworld.pl, vgt@pro.wp.pl)
    • 


        






Methods
























Class Details



[line 37]

obsluga wyswietlania map google'a

klasa sluzaca do generowania kodu JS dla map google'a
UWAGA! Aby mapa poprawnie sie wyswietlala - konieczne jest dodanie dwoch parametrow do taga <body>: <body onload="load()" onunload="GUnload()">
Aby rysowane linie poprawnie wyswietlaly sie w przegladarce Internet Explorer, konieczne jest zdefiniowanie nastepujacych styli: 		v\:* { 		behavior:url(#default#VML); 		}
a takze nastepujacych parametrow w tagu <html>: <html xmlns="http://www.w3.org/1999/xhtml" xmlns:v="urn:schemas-microsoft-com:vml">





Tags:





  

    author:  VGT
  

  

    version:  1.4
  

  

    copyright:  Copyright (c) 2007-2008, Tomek Gubala (http://www.vgtworld.pl, vgt@pro.wp.pl)
  

  

    example:  przyklad uzycia klasy
  










[ Top ]








Class Methods




  

	
	
constructor VgtGoogleMap [line 123]

	

    

    

		VgtGoogleMap VgtGoogleMap(
string
$sKlucz, [string
$sWersja = '2'], [String
$sJezyk = 'en'])
    

    


	
		konstruktor - przygotowanie zmiennych obiektu do pracy





	
        
Parameters:

    

    

          

        string  
        $sKlucz  
        klucz mapy google'a
      

          

        string  
        $sWersja  
        opcjonalnie mozliwosc zdefiniowania uzywanej wersji mapy (niektore funkcjonalnosci moga tego wymagac)
      

          

        String  
        $sJezyk  
        opcjonalna mozliwosc zdefiniowania jezyka, w ktorym bedzie wyswietlany interface mapy (na dzien dzisiejszy [2007-12-30]jezyk polski jest jeszcze niedostepny)
      

        

    


        
[ Top ]

  

  

	
	
method akcjaWyswietlOpis [line 451]

	

    

    

		string akcjaWyswietlOpis(
[integer
$iIdMarkera = -1], [string
$sIdMapy = 0])
    

    


	
		zwraca kod wywolujacy wyswietlenie opisu markera

metoda moze byc uzywana takze po wygenerowaniu kodu JS za pomoca metody jsGeneruj()
kod ten moze byc uzyty dla dowolnego elementu i dowolnej akcji (np. onclick)





Tags:





  

    since:  0.3
  









	
        
Parameters:

    

    

          

        integer  
        $iIdMarkera  
        kolejny numer markera na danej mapie (rozpoczynajac od 0), jesli nie podany, uzyty zostaje ostatnio zdefiniowany marker.                     od ver. 1.4 mozliwe jest podanie identyfikatora zwroconego przez metode dodajMarker().
      

          

        string  
        $sIdMapy  
        identyfikator mapy, jesli nie podany, uzyty zostaje identyfikator aktualnie edytowanej mapy.                     jesli jako iIdMarkera, podany zostal identyfikator zwrocony przez metode dodajMarker(), ten parametr mozna pozostawic pusty
      

        

    


        
[ Top ]

  

  

	
	
method centrujMape [line 657]

	

    

    

		void centrujMape(
)
    

    


	
		metoda centruje aktualnie edytowana mape tak, aby w polu widzenia zmiescily sie wszystkie markery i linie dodane przed wywolaniem tej metody





Tags:





  

    since:  1.3
  









	
        
[ Top ]

  

  

	
	
method dodajIkone [line 366]

	

    

    

		integer dodajIkone(
string
$sMarker, string
$sCien, integer
$iMarkerSzer, integer
$iMarkerWys, integer
$iCienSzer, integer
$iCienWys, integer
$iAnchorX, integer
$iAnchorY, integer
$iInfoX, integer
$iInfoY)
    

    


	
		zdefiniowanie wlasnej ikony do wyswietlania markerow na mapie

metoda zwraca identyfikator utworzonej ikony, ktory mozna podac przy wstawianiu markera na mape





Tags:





  

    since:  0.1
  









	
        
Parameters:

    

    

          

        string  
        $sMarker  
        sciezka do obrazka zawierajacego wyglad markera
      

          

        string  
        $sCien  
        sciezka do obrazka zawierajacego cien markera
      

          

        integer  
        $iMarkerSzer  
        szerokosc obrazka zawierajacego wyglad markera w pikselach
      

          

        integer  
        $iMarkerWys  
        wysokosc obrazka zawierajacego wyglad markera w pikselach
      

          

        integer  
        $iCienSzer  
        szerokosc obrazka zawierajacego cien markera w pikselach
      

          

        integer  
        $iCienWys  
        wysokosc obrazka zawierajacego cien markera w pikselach
      

          

        integer  
        $iAnchorX  
        wspolrzedna X markera odpowiadajaca za wskazywanie punktu na mapie
      

          

        integer  
        $iAnchorY  
        wspolrzedna Y markera odpowiadajaca za wskazywanie punktu na mapie
      

          

        integer  
        $iInfoX  
        wspolrzedna X markera, do ktorej b飺ie podczepiony dymek z opisem
      

          

        integer  
        $iInfoY  
        wspolrzedna Y markera, do ktorej b飺ie podczepiony dymek z opisem
      

        

    


        
[ Top ]

  

  

	
	
method dodajMarker [line 394]

	

    

    

		String dodajMarker(
float
$fSzerokoscGeo, float
$fDlugoscGeo, [integer
$iIdIkona = -1])
    

    


	
		dodaje marker do aktualnie tworzonej mapy

od ver. 1.4 metoda zwraca identyfikator dodanego markera, ktory nastepnie mozna wykorzystac w metodzie akcjaWyswietlOpis()





Tags:





  

    since:  0.1
  









	
        
Parameters:

    

    

          

        float  
        $fSzerokoscGeo  
        szerokosc geograficzna, na kt򱤪 ma byc umieszczony marker
      

          

        float  
        $fDlugoscGeo  
        dlugosc geograficzna, na ktorej ma by䟵mieszczony marker
      

          

        integer  
        $iIdIkona  
        identyfikator zdefiniowanej wczesniej ikony, za pomoca ktorej ma byc wyswietlony marker
      

        

    


        
[ Top ]

  

  

	
	
method jsGeneruj [line 713]

	

    

    

		void jsGeneruj(
[boolean
$bReturn = false])
    

    


	
		generowanie kodu JavaScript dla wszystkich zdefiniowanych map





Tags:





  

    since:  0.1
  









	
        
Parameters:

    

    

          

        boolean  
        $bReturn  
        okresla, czy metoda ma wyswietlac, czy zwracac kod JavaScript (domyslnie false - wyswietla)
      

        

    


        
[ Top ]

  

  

	
	
method linia [line 499]

	

    

    

		void linia(
[string
$sKolor = '#0000FF'], [integer
$iGrubosc = 10])
    

    


	
		



Tags:





  

    since:  1.0
  









	
        
Parameters:

    

    

          

        string  
        $sKolor  
        kolor linii okreslany za pomoca skladni html'owej, np. #FF0000, ff9900
      

          

        integer  
        $iGrubosc  
        grubosc rysowanej linii
      

        

    


        
[ Top ]

  

  

	
	
method liniaDodajPunkt [line 526]

	

    

    

		void liniaDodajPunkt(
float
$fSzerokoscGeo, float
$fDlugoscGeo)
    

    


	
		dodanie punktu dla aktualnie tworzonej linii i aktualnie edytowanej mapy





Tags:





  

    since:  1.0
  









	
        
Parameters:

    

    

          

        float  
        $fSzerokoscGeo  
        szerokosc geograficzna punktu
      

          

        float  
        $fDlugoscGeo  
        dlugosc geograficzna punktu
      

        

    


        
[ Top ]

  

  

	
	
method markerDodajOpis [line 415]

	

    

    

		void markerDodajOpis(
string
$sOpis)
    

    


	
		dodaje opis do ostatnio utworzonego markera dla aktualnie edytowanej mapy





Tags:





  

    since:  0.1
  









	
        
Parameters:

    

    

          

        string  
        $sOpis  
        tresc opisu markera
      

        

    


        
[ Top ]

  

  

	
	
method markerZakladkaDodajOpis [line 428]

	

    

    

		void markerZakladkaDodajOpis(
string
$sNazwaZakladki, string
$sOpis)
    

    


	
		dodaje opis w postaci zakladek do ostatnio utworzonego markera dla aktualnie edytowanej mapy

kazde kolejne wywolanie tej metody to utworzenie kolejnej zakladki dla markera





Tags:





  

    since:  0.2
  









	
        
Parameters:

    

    

          

        string  
        $sNazwaZakladki  
        nazwa zakladki
      

          

        string  
        $sOpis  
        tresc opisu w danej zakladce
      

        

    


        
[ Top ]

  

  

	
	
method nowaMapa [line 192]

	

    

    

		void nowaMapa(
string
$sDivId, float
$fSzerokoscGeo, float
$fDlugoscGeo, integer
$iZoom)
    

    


	
		rozpoczecie tworzenia nowej mapy





Tags:





  

    since:  0.1
  









	
        
Parameters:

    

    

          

        string  
        $sDivId  
        identyfikator div'a, kt򱷠ma zawierac dana mape
      

          

        float  
        $fSzerokoscGeo  
        szerokosc geograficzna centralnego punktu na wyswietlanej mapie
      

          

        float  
        $fDlugoscGeo  
        dlugosc geograficzna centralnego punktu na wyswietlanej mapie
      

          

        integer  
        $iZoom  
        poziom przyblizenia mapy
      

        

    


        
[ Top ]

  

  

	
	
method obslugaKlikniecia [line 548]

	

    

    

		void obslugaKlikniecia(
String
$sNazwaFunkcji)
    

    


	
		Aktywuje obsluge klikniec na mapie dla aktualnie edytowanej mapy

Jako parametr nalezy podac nazwe stworzonej funkcji JavaScript (bez nawiasow), ktora przyjmie maksymalnie cztery parametry - kolejno: szerokosc geograficzna, dlugosc geograficzna, zoom mapy, typ wyswietlanej mapy Jezeli kliknieto, na mapie, zostanie wywolana podana funkcja z czterema parametrami, jezeli kliknieto na markerze (co powoduje anulowanie wczesniejszego zaznaczenia) - funkcja bedzie wywolana bez parametrow





Tags:





  

    since:  1.0
  









	
        
Parameters:

    

    

          

        String  
        $sNazwaFunkcji  
        nazwa funkcji JavaScript wywolywanej w momencie klikniecia na mapie.
      

        

    


        
[ Top ]

  

  

	
	
method obslugaWyznaczaniaTrasy [line 601]

	

    

    

		void obslugaWyznaczaniaTrasy(
String
$sNazwaFunkcji, [String
$sWyznaczonePunkty = ''])
    

    


	
		aktywuje obsluge wyznaczania trasy dla aktualnie edytowanej mapy

jako parametr nalezy podac nazwe stworzonej funkcji JavaScript (bez nawiasow), ktora przyjmuje maksymalnie jeden parametr: liste punktow dla wyznaczanej trasy. Separatorem rozdzielajacym kolejne punkty jest "|", natomiast separatorem wspolrzednych danego punktu jest ",". Przykladowa zawartosc parametru z dwoma punktami wyglada tak:
53.589040571019886,19.558753967285156|53.58119404085943,19.61008071899414
Dane w dokladnie takim samym formacie mozna przekazac do drugiego parametru metody, aby na mapie od razu zostala zaznaczona trasa z mozliwoscia jej dalszej edycji.





Tags:





  

    since:  1.4
  









	
        
Parameters:

    

    

          

        String  
        $sNazwaFunkcji  
        nazwa funkcji JavaScript wywolywanej w momencie jakiejkolwiek zmiany wyznaczanej trasy
      

          

        String  
        $sWyznaczonePunkty  
        opcjonalna lista punktow, z ktorych ma zostac wygenerowana trasa od razu po wczytaniu mapy
      

        

    


        
[ Top ]

  

  

	
	
method obslugaZmianyTypuMapy [line 578]

	

    

    

		void obslugaZmianyTypuMapy(
String
$sNazwaFunkcji)
    

    


	
		aktywuje obsluge zmiany typu mapy dla aktualnie edytowanej mapy

jako parametr nalezy podac nazwe stworzonej funkcji JavaScript (bez nawiasow), ktora przyjmuje maksymalnie jeden parametr: nazwe typu mapy, na ktory nastapila zmiana (map, satellite, hybrid)





Tags:





  

    since:  1.1
  









	
        
Parameters:

    

    

          

        String  
        $sNazwaFunkcji  
        nazwa funkcji JavaScript wywolywanej w momencie zmiany typu mapy
      

        

    


        
[ Top ]

  

  

	
	
method obslugaZmianyZooma [line 563]

	

    

    

		void obslugaZmianyZooma(
String
$sNazwaFunkcji)
    

    


	
		aktywuje obsluge zmiany zooma dla aktualnie edytowanej mapy

jako parametr nalezy podac nazwe stworzonej funkcji JavaScript (bez nawiasow), ktora przyjmuje maksymalnie dwa parametry - kolejno: aktualny zoom, poprzedni zoom





Tags:





  

    since:  1.1
  









	
        
Parameters:

    

    

          

        String  
        $sNazwaFunkcji  
        nazwa funkcji JavaScript wywolywanej w momencie zmiany zooma mapy
      

        

    


        
[ Top ]

  

  

	
	
method trasa [line 640]

	

    

    

		boolean trasa(
Array
$aPunkty, [String
$sIdNawigacja = ''], [String
$sFunkcja = ''])
    

    


	
		metoda rysuje na mapie najoptymalniejsza trase przejazdu wyznaczona przez podane punkty

punkty mozna podawac jako wspolrzedne geograficzne, np: "53.7833, 20.4833", lub jako adresy: "poland, olsztyn, lubelska 43"
w przypadku podania identyfikatora dla nawigacji w podanym elemencie html, pojawi sie klikalna lista punktow posrednich wytyczonej trasy przejazdu
UWAGA!!! aktualnie wyznaczanie tras nie jest dostepne w standardowej stabilnej wersji mapy. Aby skorzystac z wyznaczania tras nalezy przy tworzeniu obiektu mapy zdefiniowac wersje, jako: "2.x"





Tags:





  

    since:  1.2
  









	
        
Parameters:

    

    

          

        Array  
        $aPunkty  
        Lista kolejnych punktow, przez ktore ma byc przeprowadzona trasa
      

          

        String  
        $sIdNawigacja  
        identyfikator elementu html strony, w ktorym ma byc wyswietlana lista punktow posrednich trasy
      

          

        String  
        $sFunkcja  
        nazwa funkcji JavaScript wywolywanej po wygenerowaniu trasy. Funkcja powinna przyjmowac dwa parametry: laczny dystans trasy w metrach i laczny czas przejazdu trasy w sekundach
      

        

    


        
[ Top ]

  

  

	
	
method ustawieniaDomyslneMap [line 152]

	

    

    

		void ustawieniaDomyslneMap(
boolean
$bTypMapy, boolean
$bDuzeKontrolki, boolean
$bMaleKontrolki, boolean
$bZoom, boolean
$bSkala, boolean
$bMapaMiniatura, boolean
$bDoubleClick, String
$sWyswietlanyTypMapy)
    

    


	
		pozwala na zdefiniowanie, ktore elementy interface'u maja byc wyswietlane na mapach





Tags:





  

    since:  0.4
  









	
        
Parameters:

    

    

          

        boolean  
        $bTypMapy  
        okresla, czy wyswietlac przyciski map, satelite, hybrid
      

          

        boolean  
        $bDuzeKontrolki  
        okresla, czy wyswietlac duze kontrolki do przesuwania i skalowania mapy
      

          

        boolean  
        $bMaleKontrolki  
        okresla, czy wyswietlac male kontrolki do przesuwania i skalowania mapy
      

          

        boolean  
        $bZoom  
        okresla, czy wyswietlac przyciski pozwalajace na zwiekszenie i zmniejszenie przyblizenia
      

          

        boolean  
        $bSkala  
        okresla, czy wyswietlac skale prezentujaca dystans w kilometrach i milach
      

          

        boolean  
        $bMapaMiniatura  
        okresla, czy wyswietlac miniaturowa mape okolicy w prawym dolnym narozniku
      

          

        boolean  
        $bDoubleClick  
        okresla, czy aktywowac mozliwosc przyblizania mapy za pomoca dwukrotnego klikniecia
      

          

        String  
        $sWyswietlanyTypMapy  
        okresla, jaki typ mapy ma byc wyswietlany (Map, Satellite, Hybrid)
      

        

    


        
[ Top ]

  

  

	
	
method ustawieniaSetDoubleClick [line 319]

	

    

    

		void ustawieniaSetDoubleClick(
boolean
$bSet)
    

    


	
		pozwala zdefiniowac dla konkretnej mapy niezaleznie od ustawien domyslnych, czy aktywowac przyblizanie mapy za pomoca dwukrotnego klikniecia





Tags:





  

    since:  0.4
  









	
        
Parameters:

    

    

          

        boolean  
        $bSet  
        okresla, czy aktywowac przyblizanie mapy za pomoca dwukrotnego klikniecia dla aktualnie edytowanej mapy
      

        

    


        
[ Top ]

  

  

	
	
method ustawieniaSetDuzeKontrolki [line 249]

	

    

    

		void ustawieniaSetDuzeKontrolki(
boolean
$bSet)
    

    


	
		pozwala zdefiniowac dla konkretnej mapy niezaleznie od ustawien domyslnych, czy wyswietlac duze kontrolki





Tags:





  

    since:  0.4
  









	
        
Parameters:

    

    

          

        boolean  
        $bSet  
        okresla, czy wyswietlac duze kontrolki dla aktualnie edytowanej mapy
      

        

    


        
[ Top ]

  

  

	
	
method ustawieniaSetMaleKontrolki [line 263]

	

    

    

		void ustawieniaSetMaleKontrolki(
boolean
$bSet)
    

    


	
		pozwala zdefiniowac dla konkretnej mapy niezaleznie od ustawien domyslnych, czy wyswietlac male kontrolki





Tags:





  

    since:  0.4
  









	
        
Parameters:

    

    

          

        boolean  
        $bSet  
        okresla, czy wyswietlac male kontrolki dla aktualnie edytowanej mapy
      

        

    


        
[ Top ]

  

  

	
	
method ustawieniaSetMapaMiniatura [line 305]

	

    

    

		void ustawieniaSetMapaMiniatura(
boolean
$bSet)
    

    


	
		pozwala zdefiniowac dla konkretnej mapy niezaleznie od ustawien domyslnych, czy wyswietlac miniaturowa mape okolicy





Tags:





  

    since:  0.4
  









	
        
Parameters:

    

    

          

        boolean  
        $bSet  
        okresla, czy wyswietlac miniaturowa mape okolicy dla aktualnie edytowanej mapy
      

        

    


        
[ Top ]

  

  

	
	
method ustawieniaSetSkala [line 291]

	

    

    

		void ustawieniaSetSkala(
boolean
$bSet)
    

    


	
		pozwala zdefiniowac dla konkretnej mapy niezaleznie od ustawien domyslnych, czy wyswietlac skale prezentujaca dystans w kilometrach i milach





Tags:





  

    since:  0.4
  









	
        
Parameters:

    

    

          

        boolean  
        $bSet  
        okresla, czy wyswietlac skale prezentujaca dystans w kilometrach i milach dla aktualnie edytowanej mapy
      

        

    


        
[ Top ]

  

  

	
	
method ustawieniaSetTypMapy [line 235]

	

    

    

		void ustawieniaSetTypMapy(
boolean
$bSet)
    

    


	
		pozwala zdefiniowac dla konkretnej mapy niezaleznie od ustawien domyslnych, czy wyswietlac przyciski: map, satelite, hybrid





Tags:





  

    since:  0.4
  









	
        
Parameters:

    

    

          

        boolean  
        $bSet  
        okresla, czy wyswietlac przyciski map, satelite, hybrid dla aktualnie edytowanej mapy
      

        

    


        
[ Top ]

  

  

	
	
method ustawieniaSetWyswietlanyTypMapy [line 333]

	

    

    

		void ustawieniaSetWyswietlanyTypMapy(
String
$sTyp)
    

    


	
		pozwala zdefiniowac, jaki typ mapy ma byc wyswietlany





Tags:





  

    since:  1.1
  









	
        
Parameters:

    

    

          

        String  
        $sTyp  
        typ wyswietlanej mapy (map, satellite, hybrid)
      

        

    


        
[ Top ]

  

  

	
	
method ustawieniaSetZoom [line 277]

	

    

    

		void ustawieniaSetZoom(
boolean
$bSet)
    

    


	
		pozwala zdefiniowac dla konkretnej mapy niezaleznie od ustawien domyslnych, czy wyswietlac przyciski zoom'a





Tags:





  

    since:  0.4
  









	
        
Parameters:

    

    

          

        boolean  
        $bSet  
        okresla, czy wyswietlac przyciski zoom'a dla aktualnie edytowanej mapy
      

        

    


        
[ Top ]

  

  

	
	
method wyswietlOpis [line 478]

	

    

    

		boolean wyswietlOpis(
)
    

    


	
		powoduje, ze opis do ostatnio dodanego markera zostanie wyswietlony automatycznie po zaladowaniu danej mapy

Metode nalezy wywolywac po zdefiniowaniu opisu dla danego markera





Tags:





  

    since:  0.3
  









	
        
[ Top ]

  






        

		    

		    Documentation generated on Fri, 02 Apr 2010 13:22:45 +0200 by phpDocumentor 1.4.3