Yer Ayrıntıları bileşeni

Places UI Kit'in Yer Ayrıntıları bileşeni, uygulamanızda yer ayrıntılarını gösteren ayrı bir kullanıcı arayüzü bileşeni eklemenize olanak tanır. Bu bileşen özelleştirilebilir.

Yer ayrıntıları kompakt bileşeni

Yer Ayrıntıları bileşeni, bağımsız olarak veya diğer Google Haritalar Platformu API'leri ve hizmetleriyle birlikte kullanılabilir. Bileşen, yer kimliği, kaynak adı veya enlem/boylam koordinatlarını alır ve oluşturulan yer ayrıntıları bilgilerini döndürür.

Yer Ayrıntıları bileşeni, kullanım alanınıza ve görsel marka kurallarınıza uyacak şekilde yazı tiplerini, renkleri ve köşe yarıçaplarını özelleştirmenize olanak tanıyan tam temalı bir bileşendir. Özel PlacesMaterialTheme değerleri sağlayarak yer ayrıntılarının görünümünü özelleştirebilirsiniz. Her biri yerle ilgili gösterilen bir bilgiye karşılık gelen PlaceDetailsCompactView girişlerinin listesini belirterek hangi yer ayrıntıları alanlarının dahil edileceğini de özelleştirebilirsiniz.

Düzen varyantları

Yer Ayrıntıları bileşeni iki ana düzen varyantını destekler:

  • Kompakt: Önemli bilgileri önizlemek için kullanılan bir düzendir.
  • Tam: Mevcut tüm yer ayrıntılarını gösteren kapsamlı bir düzen.

Kompakt düzen, dikey veya yatay yönde görüntülenebilir. Bu sayede bileşeni çeşitli tasarım düzenlerine ve ekran boyutlarına entegre edebilirsiniz. Tam düzen yalnızca dikey olarak görüntülenebilir.

yatay ve dikey düzenler
Yatay ve dikey düzenler

Yer Ayrıntıları bileşeni, bileşende gösterilen içerik üzerinde ayrıntılı kontrol sağlar. Her öğe (ör. fotoğraflar, yorumlar ve iletişim bilgileri) ayrı ayrı gösterilebilir veya gizlenebilir. Bu sayede bileşenlerin görünümü ve bilgi yoğunluğu hassas bir şekilde özelleştirilebilir.

Yer ayrıntıları içerik seçenekleri
İçerik görüntüleme seçenekleri

Yer Ayrıntıları kompakt görünümü

Yer Ayrıntıları kompakt görünümü (PlaceDetailsCompactView), seçilen bir yerin ayrıntılarını minimum alan kullanarak gösterir. Bu özellik, haritadaki bir yeri vurgulayan bilgi penceresinde, sohbette konum paylaşma gibi sosyal medya deneyimlerinde, mevcut konumunuzu seçme önerisi olarak veya bir medya makalesinde Google Haritalar'daki yere referans vermek için kullanılabilir.

Yer Ayrıntıları tam görünümü

Yer ayrıntıları tam görünümü (PlaceDetailsView), yer ayrıntısı bilgilerini görüntülemek için daha geniş bir yüzey sunar ve daha fazla bilgi türü göstermenize olanak tanır.

İçerik görüntüleme seçenekleri

PlaceDetailsCompactContent veya PlaceDetailsContent içindeki enum'ları kullanarak hangi içeriğin gösterileceğini belirtebilirsiniz.

Kompakt görünüm Tam görünüm
  • Yer fotoğrafı
  • Medya ışıklı kutusu varsa tam ekran medya galerisi etkinleştirilir.
  • Yer adresi
  • Puan ve puan sayısı
  • Yer türü
  • Fiyat
  • Erişilebilir giriş bilgileri
  • Şu anda açık durumu
  • Yer fotoğrafı kolajı
  • Yer adresi
  • Puan ve puan sayısı
  • Yer türü
  • Fiyat
  • Erişilebilirlik bilgileri
  • Şu anda açık durumu
  • Çalışma saatleri
  • İçerik özeti
  • Web sitesi
  • Telefon numarası
  • Yorumlar özel sekmede gösterilir
  • Plus code
  • Özel bir sekmede oluşturulan özellik listesi
  • Türe özgü öne çıkanlar (ör. benzin istasyonları için benzin fiyatları)
  • Popüler saatler

Faturalandırma

Yer Ayrıntıları kullanıcı arayüzü Kit'ini kullanırken PlaceDetailsQuery yönteminin her çağrılışı için faturalandırılırsınız. Aynı yeri birden fazla kez yüklerseniz her istek için faturalandırılırsınız.

Temsilci tabanlı uygulamalar için jetonlar

Temsilci tabanlı veri görselleştirme jetonu, temsilci tabanlı uygulamanızın Haritalar deneyimi ajan araçları (eski adıyla Maps Grounding Lite) yanıtındaki yerler için Places UI Kit öğelerini ek ücret ödemeden görüntülemesine olanak tanır. Daha fazla bilgi için Temsilci tabanlı veri görselleştirme jetonu başlıklı makaleyi inceleyin.

Uygulamanıza yer ayrıntıları ekleme

Yer Ayrıntıları bileşeni, bir Swift UI görünümüdür. Yer ayrıntıları bilgilerinin görünümünü ve tarzını ihtiyaçlarınıza ve uygulamanızın görünümüne uyacak şekilde özelleştirebilirsiniz. Özelleştirme hakkında daha fazla bilgi edinin.

Yer Ayrıntıları bileşenini bir yer kimliği, kaynak adı veya enlem/boylam koordinatlarıyla yüklemeyi seçebilirsiniz. İstediğiniz yöntemi veya birden fazla yöntemi seçebilirsiniz. PlaceDetailsQuery yapısındaki identifier değerini .placeID, .resourceName veya .coordinate olarak ayarlayın.

Kompakt görünümün varsayılan konumu dikeydir. Yatay bir düzen istiyorsanız PlaceDetailsCompactView içinde orientation: .horizontal değerini belirtin. İsterseniz netlik sağlamak için orientation: .vertical da belirtebilirsiniz. Tam görünüm yalnızca dikey olarak görüntülenebilir.

Yer Ayrıntıları bileşeni örnekleri bölümündeki örneklere bakın.

Görsel görünümü özelleştirme

Özel stil

Yer Ayrıntıları bileşeninizin renklerini, tipografisini, boşluklarını, kenarlıklarını ve köşelerini özelleştirebilirsiniz.

Places UI Kit, görsel özelleştirme için kabaca Materyal Tasarım'a dayalı (Google Haritalar'a özgü bazı değişikliklerle birlikte) bir tasarım sistemi yaklaşımı sunar. Materyal Tasarım'ın Renk ve Tipografi referansına bakın. Varsayılan olarak stil, Google Haritalar görsel tasarım diline uygundur.

Places UI Kit varsayılan olarak koyu tema sağlar. Bu nedenle hem koyu hem de açık temaları özelleştirmeniz gerekebilir. Koyu temayı özelleştirmek için özel temanıza .dark ve attribution.darkModeColor değerlerini ekleyin.

Stil oluşturma hakkında daha fazla bilgi için Özel stil oluşturma bölümüne bakın.

Genişlik ve yükseklik özelleştirme

Kompakt görünümler

Önerilen genişlikler:

  • Dikey yön: 180 piksel ile 300 piksel arasında.
  • Yatay yön: 180 piksel ile 500 piksel arasında.

En iyi uygulama, kompakt görünümler için yükseklik ayarlamamaktır. Bu sayede, penceredeki içerik yüksekliği ayarlayabilir ve tüm bilgilerin gösterilmesini sağlayabilir.

160 pikselden küçük genişlikler doğru şekilde görüntülenmeyebilir.

Tam görüntülemeler

Tam görünümler için önerilen genişlik 250 piksel ile 450 piksel arasındadır. 250 pikselden küçük genişlikler doğru şekilde görüntülenmeyebilir.

Bileşenin yüksekliğini ayarlayabilirsiniz. Dikey Yer Ayrıntıları görünümü, ayrılan alan içinde dikey olarak kaydırılır.

En iyi uygulama, tam görünümler için bir yükseklik ayarlamaktır. Bu sayede, penceredeki içerik düzgün bir şekilde kaydırılabilir.

Yer Ayrıntıları bileşeni örnekleri

Dikey düzende tam görünüm oluşturma

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
    )

Yatay düzende kompakt bir görünüm oluşturma

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
    )

Dikey düzende tam görünüm oluşturma

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
  )

Özel stil özelliklerini özelleştirme

Bu örnekte, tam veya kompakt görünümün varsayılan stil özelliklerinin nasıl özelleştirileceği gösterilmektedir.

Places UI Kit varsayılan olarak koyu tema sağlar. Bu nedenle hem koyu hem de açık temaları özelleştirmeniz gerekebilir. Koyu temayı özelleştirmek için özel temanıza .dark ve attribution.darkModeColor değerlerini ekleyin.

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
}

Belirli içerikleri görüntüleme

Bu örnekte, önceki örnekte oluşturulan tema kullanılarak yalnızca medya, adres, puan ve türü gösteren kompakt bir görünüm oluşturulur.

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)
  }