Opis
Do wyświetlania zdjęć Street View używana jest panorama.
Należy utworzyć za pomocą [[GMSPanoramaView alloc] initWithFrame:] i skonfigurować po inicjowaniu.
Dostęp do wszystkich właściwości i metod należy uzyskać w wątku głównym, podobnie jak w przypadku wszystkich obiektów UIKit. Metody GMSPanoramaViewDelegate zostaną również wywoływane z powrotem tylko w wątku głównym.
Kolor tła jest wyświetlany, gdy nie jest widoczna żadna panorama, np. podczas jej wczytywania lub wtedy, gdy panorama jest później ustawiona na nil. Kolor alfa parametru backgroundColor nie jest obsługiwany.
Publiczne funkcje członków | |
| (void) | – setAllgessEnabled: |
| Określa, czy wszystkie gesty mają być włączone (domyślnie) czy wyłączone. | |
| (void) | – animateToCamera:animationDuration: |
Zmienia aparat w GMSPanoramaView na camera w czasie duration (określonym w sekundach). | |
| (void) | – updateCamera:animationDuration: – |
Modyfikuje kamerę zgodnie z ustawieniami cameraUpdate, ponad duration (określone w sekundach). | |
| (void) | – moveNearCoordinate: |
Prośba o panoramę w pobliżu: coordinate. | |
| (void) | - moveNearCoordinate:radius: |
Podobnie jak w przypadku przesunięcieNearCoordinate: ale umożliwia określenie promienia wyszukiwania (w metrach) wokół obszaru coordinate. | |
| (void) | – moveNearCoordinate:source: |
Działa podobnie jak przeniesieniuNearCoordinate, ale umożliwia określenie źródła w pobliżu coordinate. | |
| (void) | - moveNearCoordinate:radius:source: |
Działa podobnie jak przesunięcieNearCoordinate: ale umożliwia określenie promienia wyszukiwania (w metrach) wokół obszaru coordinate i źródła. | |
| (void) | – moveToPanoramaID: |
Pyta o panoramę w panoramaID. | |
| (CGPoint) | – pointForOrientation: |
W bieżącym widoku zwraca punkt ekranu, przez który punkt orientation jest wskazywany. | |
| (GMSOrientation). | – orientationForPoint: |
| Biorąc pod uwagę punkt tego widoku, zwraca bieżącą orientację aparatu wskazującą lokalizację ekranu. | |
Statyczne publiczne funkcje członkowskie | |
| (typ instancji) | + panoramaWithFrame:nearCoordinate: |
Wygodny konstruktor dla GMSPanoramaView, który wyszukuje i wyświetla GMSPanorama w pobliżu coordinate. | |
| (typ instancji) | + panoramaWithFrame:nearCoordinate:radius: |
Działa podobnie jak panoramaWithFrame:nearCoordinate:, ale umożliwia określenie promienia wyszukiwania (w metrach) wokół obszaru coordinate. | |
| (typ instancji) | + panoramaWithFrame:nearCoordinate:source: |
Wygodny konstruktor dla GMSPanoramaView, który wyszukuje i wyświetla GMSPanorama w pobliżu coordinate. | |
| (typ instancji) | + panoramaWithFrame:nearCoordinate:radius:source: |
Wygodny konstruktor dla GMSPanoramaView, który wyszukuje i wyświetla GMSPanorama w pobliżu coordinate. | |
Usługi | |
| GMSPanorama * | panorama |
| Panorama do wyświetlenia. Jej ustawienie spowoduje przejście do nowej panoramy. | |
| IBOutlet id < GMSPanoramaViewDelegate > | przekazać |
| Delegat GMSPanoramaView. | |
| BOOL | orientationGestures |
| Określa, czy gesty orientacji mają być włączone (domyślnie) czy wyłączone. | |
| BOOL | zoomGestures |
| Określa, czy gesty powiększania mają być włączone (domyślnie) czy wyłączone. | |
| BOOL | navigationGestures |
| Określa, czy gesty nawigacyjne mają być włączone (domyślnie) czy wyłączone. | |
| BOOL | navigationLinksHidden |
| Określa, czy klikalne linki nawigacyjne mają być ukryte czy widoczne (domyślnie). | |
| BOOL | streetNamesHidden |
| Określa, czy nakładki z nazwami ulic mają być ukryte czy widoczne (domyślnie). | |
| GMSPanoramaCamera * | aparat |
| Steruje aparatem panoramy. | |
| GMSPanoramaLayer * | Warstwa |
| Metoda dostępu do niestandardowego typu CALayer używanego w warstwie. | |
Dokumentacja funkcji członka grupy
| – (void) setAllgessEnabled: | (BOOL) | włączone |
Określa, czy wszystkie gesty mają być włączone (domyślnie) czy wyłączone.
Nie ogranicza to automatycznego ruchu aparatu ani kontroli nad panoramą.
| - (void) animacjaDoAparatu: | (GMSPanoramaCamera *) | aparat | |
| czas trwania animacji: | (NSTimeInterval) | duration (czas trwania) | |
Zmienia aparat w GMSPanoramaView na camera w czasie duration (określonym w sekundach).
| - (void) aktualizacja kamery: | (GMSPanoramaCameraUpdate *) | cameraUpdate | |
| czas trwania animacji: | (NSTimeInterval) | duration (czas trwania) | |
Modyfikuje kamerę zgodnie z ustawieniami cameraUpdate, ponad duration (określone w sekundach).
| – (void) moveNearCoordinate: | (CLLocationCoordinate2D) | współrzędne |
Prośba o panoramę w pobliżu: coordinate.
Po pomyślnym ukończeniu panoramaView:didMoveToPanorama: i panoramaView:didMoveToPanorama:nearCoordinate: zostaną wysłane do GMSPanoramaViewDelegate.
W przypadku błędu zostanie wysłana wiadomość panoramaView:error:onMoveNearCoordinate:.
Powtarzające się wywołania funkcji MoveNearCoordinate: powodują anulowanie poprzednich oczekujących (niekompletnych) przeniesień – tylko ostatnie z nich transferNearCoordinate: i transferToPanoramaId: zostaną anulowane i wygeneruje zdarzenia.
| – (void) moveNearCoordinate: | (CLLocationCoordinate2D) | współrzędne | |
| promień: | (NSUInteger) | obszar o określonym promieniu, | |
Podobnie jak w przypadku przesunięcieNearCoordinate: ale umożliwia określenie promienia wyszukiwania (w metrach) wokół obszaru coordinate.
| – (void) moveNearCoordinate: | (CLLocationCoordinate2D) | współrzędne | |
| źródło: | (GMSPanoramaSource). | source | |
Działa podobnie jak przeniesieniuNearCoordinate, ale umożliwia określenie źródła w pobliżu coordinate.
Ten interfejs API ma charakter eksperymentalny i nie zawsze może filtrować dane według źródła.
| – (void) moveNearCoordinate: | (CLLocationCoordinate2D) | współrzędne | |
| promień: | (NSUInteger) | promień | |
| źródło: | (GMSPanoramaSource). | source | |
Działa podobnie jak przesunięcieNearCoordinate: ale umożliwia określenie promienia wyszukiwania (w metrach) wokół obszaru coordinate i źródła.
Ten interfejs API ma charakter eksperymentalny i nie zawsze może filtrować dane według źródła.
| – (void) moveToPanoramaID: | (NSString *) | panoramaID |
Pyta o panoramę w panoramaID.
Po pomyślnym ukończeniu panoramaView:didMoveToPanorama: zostanie wysłana do GMSPanoramaViewDelegate.
W przypadku błędu panoramaView:error:onMoveToPanoramaID: zostanie wysłana.
Powtarzające się wezwania do działania w celu przejścia do polamoveToPanoramaID: umożliwiają anulowanie poprzednich oczekujących (niekompletnych) operacji przenoszenia danych. W efekcie będą kontynuowane i wygenerowane zdarzenia tylko ostatnie z parametrówmoveNearCoordinate: i moveToPanoramaId:.
Obsługiwane są tylko identyfikatory panoramy uzyskane z pakietu SDK Map Google na iOS.
| – (CGPoint) pointForOrientation: | (GMSOrientation). | orientacja |
W bieżącym widoku zwraca punkt ekranu, przez który punkt orientation jest wskazywany.
Ta wartość może znajdować się poza widokiem przy orientacjach do przodu, które są wystarczająco daleko od widoku prostego.
Wynik będzie zawierał wartości NaN w przypadku orientacji kamery oddalających się od widoku tam, gdzie domniemany punkt ekranu miałby ujemną odległość od kamery w kierunku orientacji.
| - (GMSOrientation) orientationForPoint: | (CGPoint) | punkt |
Biorąc pod uwagę punkt tego widoku, zwraca bieżącą orientację aparatu wskazującą lokalizację ekranu.
W środku tego widoku zwrócona wartość GMSOrientation będzie mniej więcej równa tej wartości w bieżącym GMSPanoramaCamera.
| + (typ instancji) panoramaWithFrame: | (CGRect) | ramka | |
| w pobliżu Coordinate: | (CLLocationCoordinate2D) | współrzędne. | |
Wygodny konstruktor dla GMSPanoramaView, który wyszukuje i wyświetla GMSPanorama w pobliżu coordinate.
Powoduje to wykonanie działania podobnego jak w przypadku metody trafficNearCoordinate: z wywołaniem tych samych metod przekazywania dostępu.
| + (typ instancji) panoramaWithFrame: | (CGRect) | ramka | |
| w pobliżu Coordinate: | (CLLocationCoordinate2D) | współrzędne | |
| promień: | (NSUInteger) | obszar o określonym promieniu, | |
Działa podobnie jak panoramaWithFrame:nearCoordinate:, ale umożliwia określenie promienia wyszukiwania (w metrach) wokół obszaru coordinate.
| + (typ instancji) panoramaWithFrame: | (CGRect) | ramka | |
| w pobliżu Coordinate: | (CLLocationCoordinate2D) | współrzędne | |
| źródło: | (GMSPanoramaSource). | source | |
Wygodny konstruktor dla GMSPanoramaView, który wyszukuje i wyświetla GMSPanorama w pobliżu coordinate.
Powoduje to wykonanie działania podobnego do tego w przypadku operacjimoveNearCoordinate:source i wywołuje te same metody przekazywania dostępu.
Ten interfejs API ma charakter eksperymentalny i nie zawsze może filtrować dane według źródła.
| + (typ instancji) panoramaWithFrame: | (CGRect) | ramka | |
| w pobliżu Coordinate: | (CLLocationCoordinate2D) | współrzędne | |
| promień: | (NSUInteger) | promień | |
| źródło: | (GMSPanoramaSource). | source | |
Wygodny konstruktor dla GMSPanoramaView, który wyszukuje i wyświetla GMSPanorama w pobliżu coordinate.
Powoduje to wykonanie działania podobnego jak w przypadku operacjimoveNearCoordinate:radius:source i wywołuje te same metody przekazywania dostępu.
Ten interfejs API ma charakter eksperymentalny i nie zawsze może filtrować dane według źródła.
Dokumentacja właściwości
– (GMSPanorama*) panorama [read, write, assign] |
Panorama do wyświetlenia. Jej ustawienie spowoduje przejście do nowej panoramy.
Jest animowany, z wyjątkiem początkowej panoramy.
Aby wyczyścić widok, można użyć wartości nil.
- (IBOutlet id<GMSPanoramaViewDelegate>) delegate [read, write, assign] |
Delegat GMSPanoramaView.
- (BOOL) orientationGestures [read, write, assign] |
Określa, czy gesty orientacji mają być włączone (domyślnie) czy wyłączone.
Gdy to ustawienie jest włączone, użytkownicy mogą zmieniać orientację kamery za pomocą gestów.
Nie ogranicza to automatycznego ruchu kamery.
- (BOOL) zoomGestures [read, write, assign] |
Określa, czy gesty powiększania mają być włączone (domyślnie) czy wyłączone.
Gdy ta opcja jest włączona, użytkownicy mogą ściągnąć palce, aby powiększyć obraz.
Nie ogranicza to automatycznego ruchu kamery.
- (BOOL) navigationGestures [read, write, assign] |
Określa, czy gesty nawigacyjne mają być włączone (domyślnie) czy wyłączone.
Gdy ta opcja jest włączona, użytkownicy mogą zmieniać panoramy jednym kliknięciem, a także dwukrotnie kliknąć widok.
Nie ogranicza to automatycznej kontroli nad panoramą.
- (BOOL) navigationLinksHidden [read, write, assign] |
Określa, czy klikalne linki nawigacyjne mają być ukryte czy widoczne (domyślnie).
Nie można kliknąć ukrytych linków nawigacyjnych.
- (BOOL) streetNamesHidden [read, write, assign] |
Określa, czy nakładki z nazwami ulic mają być ukryte czy widoczne (domyślnie).
– (GMSPanoramaCamera*) aparat [read, write, assign] |
Steruje aparatem panoramy.
Ustawienie nowej kamery spowoduje przejście do nowej wartości kamery bez animacji.
- warstwa [read, retain] (GMSPanoramaLayer*) |
Metoda dostępu do niestandardowego typu CALayer używanego w warstwie.