Komponent Informacje o miejscu

Komponent informacji o miejscu w interfejsie Places UI Kit umożliwia dodanie pojedynczego komponentu interfejsu, który wyświetla informacje o miejscu w aplikacji. Ten komponent można dostosować.

Komponent kompaktowy z informacjami o miejscu

Komponentu informacje o miejscu można używać niezależnie lub w połączeniu z innymi interfejsami API i usługami Google Maps Platform. Komponent przyjmuje identyfikator miejsca, nazwę zasobu lub współrzędne szerokości i długości geograficznej oraz zwraca wyrenderowane informacje o miejscu.

Komponent informacji o miejscu jest w pełni dostosowywalny, co pozwala na dostosowanie czcionek, kolorów i promieni narożników do Twojego przypadku użycia i wytycznych dotyczących marki. Możesz dostosować wygląd informacji o miejscu, podając niestandardowe wartości PlacesMaterialTheme. Możesz też dostosować, które pola informacji o miejscu mają być uwzględniane, określając listę wpisów PlaceDetailsCompactView, z których każdy odpowiada informacji wyświetlanej o miejscu.

Warianty układu

Komponent Informacje o miejscu obsługuje 2 główne warianty układu:

  • Kompaktowy: układ do podglądu najważniejszych informacji.
  • Pełny: kompleksowy układ wyświetlający wszystkie dostępne informacje o miejscu.

Układ kompaktowy może być wyświetlany w orientacji pionowej lub poziomej. Dzięki temu możesz zintegrować komponent z różnymi układami i rozmiarami ekranu. Pełny układ można wyświetlać tylko w pionie.

układy poziome i pionowe
Układy poziome i pionowe

Komponent Informacje o miejscu zapewnia szczegółową kontrolę nad wyświetlanymi w nim treściami. Każdy element (np. zdjęcia, opinie i informacje kontaktowe) można osobno wyświetlić lub ukryć, co pozwala na precyzyjne dostosowanie wyglądu komponentów i gęstości informacji.

Opcje treści szczegółowych informacji o miejscu
Opcje wyświetlania treści

Widok kompaktowy informacji o miejscu

Widok kompaktowy informacji o miejscu (PlaceDetailsCompactView) wyświetla szczegóły wybranego miejsca, zajmując minimalną ilość miejsca. Może to być przydatne w oknie informacyjnym wyróżniającym miejsce na mapie, w mediach społecznościowych, np. podczas udostępniania lokalizacji na czacie, jako sugestia wyboru bieżącej lokalizacji lub w artykule medialnym, aby odwołać się do miejsca w Mapach Google.

Pełny widok informacji o miejscu

Pełny widok szczegółowych informacji o miejscu (PlaceDetailsView) zapewnia większą powierzchnię do wyświetlania szczegółowych informacji o miejscu i umożliwia wyświetlanie większej liczby typów informacji.

Opcje wyświetlania treści

Możesz określić, które treści mają być wyświetlane, używając typów wyliczeniowych w PlaceDetailsCompactContent lub PlaceDetailsContent.

Widok kompaktowy Pełny widok
  • Zdjęcie miejsca
  • Galeria multimediów na pełnym ekranie jest włączona, jeśli obecny jest lightbox multimediów
  • Adres miejsca
  • ocena i liczba ocen,
  • Typ miejsca
  • Cena
  • Informacje o wejściu dostępnym dla osób z niepełnosprawnością
  • Stan „Teraz otwarte”
  • Kolaż zdjęć miejsca
  • Adres miejsca
  • ocena i liczba ocen,
  • Typ miejsca
  • Cena
  • Informacje o ułatwieniach dostępu
  • Stan „Teraz otwarte”
  • Godziny otwarcia
  • Podsumowanie redakcyjne
  • Witryna
  • Numer telefonu
  • Opinie wyświetlane na specjalnej karcie
  • Plus Code
  • Lista funkcji wyświetlana na specjalnej karcie
  • najważniejsze informacje dotyczące konkretnego typu miejsca, np. ceny paliwa na stacjach benzynowych;
  • Popularne godziny

Płatności

Jeśli korzystasz z interfejsu Place Details UI Kit, opłata jest naliczana za każdym razem, gdy wywoływana jest metoda PlaceDetailsQuery. Jeśli wczytasz to samo miejsce wielokrotnie, opłata zostanie naliczona za każde żądanie.

Tokeny dla aplikacji agentowych

Token wizualizacji danych agentowych umożliwia aplikacji agentowej wyświetlanie elementów interfejsu Places UI Kit dla miejsc w odpowiedzi narzędzi agentowych Maps Experience (dawniej Grounding Lite w Mapach) bez dodatkowych opłat. Więcej informacji znajdziesz w artykule Token wizualizacji danych agentowych.

Dodawanie do aplikacji informacji o miejscu

Komponent Informacje o miejscu to widok Swift UI. Możesz dostosować wygląd i styl informacji o miejscu do swoich potrzeb i wyglądu aplikacji. Więcej informacji o dostosowywaniu

Możesz wczytać komponent Szczegóły miejsca, podając identyfikator miejsca, nazwę zasobu lub współrzędne geograficzne. Możesz wybrać dowolną metodę lub kilka z nich. Ustaw identifier w strukturze PlaceDetailsQuery na .placeID, .resourceName lub .coordinate.

Domyślna pozycja widoku kompaktowego to pionowa. Jeśli chcesz użyć układu poziomego, określ orientation: .horizontal w PlaceDetailsCompactView. Możesz też opcjonalnie określić orientation: .vertical, aby zwiększyć przejrzystość. Pełny widok można wyświetlić tylko w pionie.

Przykłady znajdziesz w sekcji Przykłady komponentu informacje o miejscu.

Dostosowywanie wyglądu

Styl niestandardowy

Możesz dostosować kolory, typografię, odstępy, obramowania i rogi komponentu Szczegóły miejsca.

Interfejs Places UI Kit oferuje podejście do dostosowywania wizualnego oparte na systemie projektowania, które jest w dużej mierze oparte na Material Design (z pewnymi modyfikacjami specyficznymi dla Map Google). Zapoznaj się z dokumentacją Material Design dotyczącą kolorów i typografii. Domyślnie styl jest zgodny z językiem projektowania wizualnego Map Google.

Pakiet Places UI Kit domyślnie udostępnia ciemny motyw, więc może być konieczne dostosowanie zarówno ciemnego, jak i jasnego motywu. Aby dostosować ciemny motyw, dodaj wartości .dark i attribution.darkModeColor do motywu niestandardowego.

Więcej informacji o stylach znajdziesz w sekcji Style niestandardowe.

Dostosowywanie szerokości i wysokości

Widoki kompaktowe

Zalecane szerokości:

  • Orientacja pionowa: od 180 do 300 pikseli.
  • Orientacja pozioma: od 180 do 500 pikseli.

Sprawdzona metoda to nieustawianie wysokości w przypadku widoków kompaktowych. Dzięki temu wysokość okna będzie dostosowywana do treści, co pozwoli na wyświetlenie wszystkich informacji.

Szerokości mniejsze niż 160 pikseli mogą nie wyświetlać się prawidłowo.

Pełne wyświetlenia

W przypadku pełnych widoków zalecana szerokość wynosi od 250 do 450 pikseli. Szerokość mniejsza niż 250 pikseli może nie wyświetlać się prawidłowo.

Możesz ustawić wysokość komponentu: pionowy widok informacji o miejscu będzie przewijany w pionie w przydzielonym miejscu.

Sprawdzoną metodą jest ustawienie wysokości dla pełnych widoków. Umożliwi to prawidłowe przewijanie treści w oknie.

Przykłady komponentu Informacje o miejscu

Tworzenie pełnego widoku z układem pionowym

Swift

  var selectedType: Set<PlaceDetailsCompactContent> = PlaceDetailsCompactView.standardContent

    @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
      identifier: .placeID("ChIJT7FdmYiAhYAROFOvrIxRJDU"))
    
    var theme: PlacesMaterialTheme()
    var configuration: PlaceDetailsConfiguration {
      PlaceDetailsConfiguration(
        content: selectedType,
        theme: theme)
    }
    
    // Callback for the place details component.
    let placeDetailsCallback: (PlaceDetailsResult) -> Void = { result in
      if let place = result.place {
        print("Place: \(place.description)")
      } else {
        print("Error: \(String(describing: result.error))")
      }
    }
    PlaceDetailsCompactView(
      orientation: .vertical, query: $query,
      configuration: configuration,
      placeDetailsCallback: placeDetailsCallback
    )

Tworzenie widoku kompaktowego z układem poziomym

Swift

  var selectedType: Set<PlaceDetailsCompactContent> = PlaceDetailsCompactView.standardContent

    @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
      identifier: .placeID("ChIJT7FdmYiAhYAROFOvrIxRJDU"))
    
    var theme: PlacesMaterialTheme()
    var configuration: PlaceDetailsConfiguration {
      PlaceDetailsConfiguration(
        content: selectedType,
        theme: theme)
    }
    
    // Callback for the place details component.
    let placeDetailsCallback: (PlaceDetailsResult) -> Void = { result in
      if let place = result.place {
        print("Place: \(place.description)")
      } else {
        print("Error: \(String(describing: result.error))")
      }
    }
    PlaceDetailsCompactView(
      orientation: .horizontal, query: $query,
      configuration: configuration,
      placeDetailsCallback: placeDetailsCallback
    )

Tworzenie pełnego widoku z układem pionowym

Swift

  @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
    identifier: .placeID("ChIJT7FdmYiAhYAROFOvrIxRJDU"))
  var theme: PlacesMaterialTheme()
  var selectedType: Set<PlaceDetailsContent> = PlaceDetailsCompactView.standardContent
  
  var configuration: PlaceDetailsConfiguration {
    PlaceDetailsConfiguration(
      content: selectedType,
      theme: theme)
  }
  let placeDetailsCallback: (PlaceDetailsResult) -> Void = { result in
    placeIDPickerFocused = true
    if let place = result.place {
      print("Place: \(place.description)")
    } else {
      print("Error: \(String(describing: result.error))")
    }
  }
  GooglePlacesSwift.PlaceDetailsView(
    query: $query,
    configuration: configuration,
    placeDetailsCallback: placeDetailsCallback
  )

Dostosowywanie atrybutów stylu niestandardowego

Ten przykład pokazuje, jak dostosować domyślne atrybuty stylu widoku pełnego lub kompaktowego.

Pakiet Places UI Kit domyślnie udostępnia ciemny motyw, więc może być konieczne dostosowanie zarówno ciemnego, jak i jasnego motywu. Aby dostosować ciemny motyw, dodaj do motywu niestandardowego wartości .dark i attribution.darkModeColor.

Swift

  // Same for compact and full
func makeTemplateTheme(colorScheme: ColorScheme) -> PlacesMaterialTheme {
  var theme = PlacesMaterialTheme()
  var color = PlacesMaterialColor()
  color.surface = (colorScheme == .dark ? .blue : .gray)
  color.buttonBorder = (colorScheme == .dark ? .pink : .orange)
  color.outlineDecorative = (colorScheme == .dark ? .white : .black)
  color.onSurface = (colorScheme == .dark ? .yellow : .red)
  color.onSurfaceVariant = (colorScheme == .dark ? .white : .blue)
  color.onSecondaryContainer = (colorScheme == .dark ? .white : .red)
  color.secondaryContainer = (colorScheme == .dark ? .green : .purple)
  color.positive = (colorScheme == .dark ? .yellow : .red)
  color.primary = (colorScheme == .dark ? .yellow : .purple)
  color.info = (colorScheme == .dark ? .yellow : .purple)
  var shape = PlacesMaterialShape()
  shape.cornerRadius = 10
  var font = PlacesMaterialFont()
  font.labelLarge = .system(size: UIFontMetrics.default.scaledValue(for: 18))
  font.headlineMedium = .system(size: UIFontMetrics.default.scaledValue(for: 15))
  font.bodyLarge = .system(size: UIFontMetrics.default.scaledValue(for: 15))
  font.bodyMedium = .system(size: UIFontMetrics.default.scaledValue(for: 12))
  font.bodySmall = .system(size: UIFontMetrics.default.scaledValue(for: 11))
  var attribution = PlacesMaterialAttribution()
  attribution.lightModeColor = .black
  attribution.darkModeColor = .white
  theme.measurement.borderWidthButton = 1
  theme.color = color
  theme.shape = shape
  theme.font = font
  theme.attribution = attribution
  return theme
}

Wyświetlanie konkretnych treści

W tym przykładzie tworzymy widok kompaktowy, który wyświetla tylko multimedia, adres, ocenę i typ, używając motywu utworzonego w poprzednim przykładzie.

Swift

  @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
    identifier: .placeID("ChIJT7FdmYiAhYAROFOvrIxRJDU"))
  
  var body: some View {
    PlaceDetailsCompactView(
      orientation: .vertical, query: $query,
      contentType: [.media(), .address(), .rating(),
                    .type(), .price()], theme: theme,
      placeDetailsCallback: placeDetailsCallback, preferTruncation: false
    )
    .frame(width: 350)
  }