مؤلفه «جزئیات پیشرفته جا»

نسخه «پیشرفته» مؤلفه «جزئیات مکان» همان ویژگی‌های مؤلفه «جزئیات مکان» نسخه Essentials را ارائه می‌دهد. همچنین به شما امکان می‌دهد:

  • انتخاب کنید که «نام مکان» نمایش داده شود یا نه.
  • دکمه‌های کنش مؤلفه را پیکربندی کنید.
  • گزینه‌های جستجو و فیلتر کردن را روی مرورها و رسانه‌های نمایش‌داده‌شده اعمال کنید.
  • جایگاه‌های محتوای سفارشی ایجاد کنید.

کدها برای برنامه‌های عامل‌گرا

بااستفاده از کد دیداری‌سازی داده‌های عامل، برنامه عامل شما می‌تواند عناصر «کیت میانای کاربر جاها» را برای مکان‌های موجود در پاسخ ابزارهای عامل Maps Experience (‏Maps Grounding Lite سابق) بدون هزینه اضافی نمایش دهد. برای اطلاعات بیشتر، به نشان داده‌نمایی عاملی مراجعه کنید.

پیکربندی پیشرفته «جزئیات جا»

برای دسترسی به ویژگی‌های پیشرفته، از AdvancedPlaceDetailsView یا AdvancedPlaceDetailsCompactView استفاده کنید.

گزینه‌های نمایش محتوا

می‌توانید بااستفاده از شمارش‌ها در AdvancedPlaceDetailsContent مشخص کنید کدام محتوا نمایش داده شود. می‌توانید همه محتواهای مشابه اصول جزئیات مکان‌ها را پیکربندی کنید و همچنین انتخاب کنید که نام «مکان» نمایش داده شود یا نه.

پیکربندی دکمه‌های کنش

از روش‌های .cornerActions و .mainActions مربوط به AdvancedPlaceDetailsView یا AdvancedPlaceDetailsCompactView برای برداشتن یا سفارشی‌سازی کردن دکمه‌های کنش استفاده کنید.

الزامات اسناددهی تصویری

نمای فشرده جزئیات مکان با دکمه‌های سفارشی‌شده
نمای فشرده «جزئیات پیشرفته مکان» با دکمه سفارشی‌شده

مهم: باید برای کاربران نهایی روشن کنید که دکمه کنش سفارشی چه زمانی اطلاعات کاربر را با طرف سومی غیراز Google هم‌رسانی خواهد کرد. الزامات ذکر منبع تصویری را ببینید.

نمونه سمت چپ تصویر سفارشی‌ای را نشان می‌دهد که به‌وضوح نشان می‌دهد اطلاعات کاربر به «Altostrat» ارسال خواهد شد.

اعمال گزینه‌های جستجو و فیلتر کردن

از روش‌های .searchMediaOptions و .searchReviewOptions مربوط به AdvancedPlaceDetailsView یا AdvancedPlaceDetailsCompactView برای فعال کردن جستجو و فیلتر کردن رسانه یا مرورها استفاده کنید.

ایجاد جایگاه‌های محتوای سفارشی

گزینه‌های جای‌گذاری جایگاه محتوای سفارشی

جایگاه‌های محتوای سفارشی به شما امکان می‌دهند محتوای خودتان (مانند خلاصه‌های تولیدشده با هوش مصنوعی، مُهرهای زمان برنامه سفر، یا نشان‌های سفارشی) را مستقیماً به مناطق چیدمان ازپیش تعریف‌شده اضافه کنید.

برای افزودن جایگاه‌های محتوای سفارشی، از روش .placeDetailsCompactContentSlot مربوط به AdvancedPlaceDetailsCompactView استفاده کنید. موقعیت‌های دردسترس .basicSectionTop و .basicSectionBottom هستند.

الزامات ذکر منبع و پیشنهادهای محتوا برای جایگاه‌های محتوا

وقتی جایگاه محتوای سفارشی نصب می‌شود، شفاف‌سازی به‌طور خودکار به‌روز می‌شود تا مشخص شود کدام محتوا توسط Google ارائه شده است و اینکه برخی‌از محتوا توسط اشخاص ثالث ارائه شده است.

Do

سلسله‌مراتب دیداری واضحی بین جزئیات «مکان Google» و محتوای سفارشی حفظ کنید تا از هرگونه ابهام درباره منبع اطلاعات جلوگیری شود.

جلوگیری از ابهام درباره منبع اطلاعات

Do

بینش‌های محلی‌سازی‌شده و ارزشمند را که متناسب با اهداف فوری کاربران شما است درنظر بگیرید. محتوای سفارشی‌سازی‌شده مانند پنجره‌های رزرو هم‌زمان یا دردسترس بودن فعلی به کاربران کمک می‌کند تصمیمات سریع‌تر و آگاهانه‌تری بگیرند.

ارائه اطلاعات آماری ارزشمند

نبایدها

جزئیات موجود «مکان Google» را، مثل رده‌بندی‌ها، مرورها، یا ساعت کاری، تکرار نکنید، حتی اگر محتوای ارائه‌شده توسط Google را پنهان کرده باشید. این کار می‌تواند کاربران را درباره منبع محتوا و اینکه آیا از Google یا طرف سوم می‌آید گیج کند.

جزئیات «مکان Google» موجود را تکرار نکنید

نبایدها

ادعاها یا نشان‌های بدون منبع (برای مثال، «توصیه برتر!») را که ممکن است با تأیید رسمی Google اشتباه گرفته شود نمایش ندهید. محتوای سفارشی باید به‌طور صریح منبع خود را ذکر کند.

ادعاها یا نشان‌های بدون منبع را نمایش ندهید

نبایدها

آگهی، متن بازاریابی، تخفیف تبلیغاتی، یا درخواست اشتراک را در محفظه‌های سفارشی مکان قرار ندهید.

آگهی، متن بازاریابی، تخفیف تبلیغاتی، یا درخواست اشتراک اضافه نکنید

نمونه‌های «جزئیات پیشرفته جا»

نام مکان را حذف کنید

برای حذف کردن نام «مکان»، .name را در پارامتر content از AdvancedPlaceDetailsConfiguration وارد نکنید.

Swift

struct DemoView: View {
  static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU"

  // Query for loading the place details component.
  @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
    identifier: .placeID(peetsCoffeePlaceID)
  )
  @State private var favoritePlaces: Set<String> = []

  var body: some View {
    AdvancedPlaceDetailsView(
      query: $query,
      configuration: AdvancedPlaceDetailsConfiguration(
        content:[.address()],
        theme: PlacesMaterialTheme()
      ),
      placeDetailsCallback: { result in
        if let place = result.place {
          print("Place: \(place.description)")
        } else {
          print("Error: \(String(describing: result.error))")
        }
      }
    )
  }
}

برداشتن دکمه‌های کنش

Swift

struct DemoView: View {
  static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU"

  @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
    identifier: .placeID(peetsCoffeePlaceID)
  )

  var body: some View {
    AdvancedPlaceDetailsView(
      query: $query,
      configuration: AdvancedPlaceDetailsConfiguration(
        content: AdvancedPlaceDetailsView.allContent,
        theme: PlacesMaterialTheme()
      ),
      placeDetailsCallback: { result in
        if let place = result.place {
          print("Place: \(place.description)")
        } else {
          print("Error: \(String(describing: result.error))")
        }
      }
    )
    .mainActions{ _ in
      return []
    }
  }
}

افزودن کنش‌های سفارشی و ازپیش‌تعریف‌شده

این نمونه گزینه‌ای را برای کاربر اضافه می‌کند تا مکانی را به موارد دلخواه اضافه کند یا از موارد دلخواه بردارد، به‌همراه کنش ازپیش تعریف‌شده باز کردن در Maps.

Swift

struct DemoView: View {
  static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU"

  @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
    identifier: .placeID(peetsCoffeePlaceID)
  )
  
  @State var favoritePlaces: Set<String> = []

  var body: some View {
    AdvancedPlaceDetailsView(
      query: $query,
      configuration: AdvancedPlaceDetailsConfiguration(
        content: AdvancedPlaceDetailsView.allContent,
        theme: PlacesMaterialTheme()
      ),
      placeDetailsCallback: { result in
        if let place = result.place {
          print("Place: \(place.description)")
        } else {
          print("Error: \(String(describing: result.error))")
        }
      }
    )
    .mainActions{ place in
      var actions: [MainPlaceActionElement] = []
      let placeID = place.placeID!
      if self.favoritePlaces.contains(placeID) {
        actions.append(
          .action(
            MainPlaceAction(
              image: Image(systemName: "heart.fill"),
              label: "Unfavorite"
            ) { _ in self.toggleFavorite(placeID) }
          )
        )
      } else {
        actions.append(
          .action(
            MainPlaceAction(
              image: Image(systemName: "heart"),
              label: "Favorite"
            ) { _ in self.toggleFavorite(placeID) }
          )
        )
      }
      actions.append(.actionId(.openMap(style: .primary)))
      return actions
    }
    .cornerActions { place in
      var actions: [CornerPlaceActionElement] = []
      let placeID = place.placeID!
      if self.favoritePlaces.contains(placeID) {
        actions.append(
          .action(
            CornerPlaceAction(
              image: Image(systemName: "heart.fill"),
              accessibilityLabel: "Unfavorite",
            ) { _ in self.toggleFavorite(placeID) }
          )
        )
      } else {
        actions.append(
          .action(
            CornerPlaceAction(
              image: Image(systemName: "heart"),
              accessibilityLabel: "Favorite",
            ) { _ in self.toggleFavorite(placeID) }
          )
        )
      }
      actions.append(.actionId(.openMap(style: .primary)))
      return actions
    }
  }

  func toggleFavorite(_ placeID: String) {
    if favoritePlaces.contains(placeID) {
      favoritePlaces.remove(placeID)
    } else {
      favoritePlaces.insert(placeID)
    }
  }
}

فیلتر کردن مرورها و رسانه‌ها

این نمونه کد فقط رسانه‌ها و مرورهایی را نشان می‌دهد که در آن‌ها به «قهوه» اشاره شده است.

Swift

struct DemoView: View {
  static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU"

  @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
    identifier: .placeID(peetsCoffeePlaceID)
  )
  let searchMediaOptions = SearchMediaOptions(query: "coffee")
  let searchReviewsOptions = SearchReviewsOptions(query: "coffee")

  var body: some View {
    AdvancedPlaceDetailsView(
      query: $query,
      configuration: AdvancedPlaceDetailsConfiguration(
        content: [.media(), .reviews()],
        theme: PlacesMaterialTheme()
      ),
      placeDetailsCallback: { _ in }
    )
    .searchMediaOptions(searchMediaOptions) { results in
      guard let result = results.first else { return }
      switch result {
      case .success(let summary):
        print("Summary: \(summary)")
      case .failure(let error):
        print("Error: \(error)")
      }
    }
    .searchReviewsOptions(searchReviewsOptions) { results in
      guard let result = results.first else { return }
      switch result {
      case .success(let summary):
        print("Summary: \(summary)")
      case .failure(let error):
        print("Error: \(error)")
      }
    }
  }
}

ایجاد جایگاه‌های محتوا

این نمونه محتوا را به جایگاه‌های basicSectionTop و basicSectionBottom اضافه می‌کند.

Swift

import SwiftUI
import PlacesSwift

struct ItineraryCard: View {
    static let peetsCoffeePlaceID = "ChIJT7FdmYiAhYAROFOvrIxRJDU"

    @State var query: PlaceDetailsQuery = PlaceDetailsQuery(
      identifier: .placeID(peetsCoffeePlaceID)
    )

    var body: some View {
      AdvancedPlaceDetailsCompactView(
        orientation: .vertical,
        query: $query,
        configuration: AdvancedPlaceDetailsCompactConfiguration(
          content: AdvancedPlaceDetailsCompactView.allContent,
          theme: PlacesMaterialTheme()
        ),
        placeDetailsCallback: { _ in }
      )
      .placeDetailsCompactContentSlot(position: .basicSectionTop) { place in
        Text("Day 2 • 2:30 PM")
          .font(.caption)
          .fontWeight(.bold)
          .foregroundColor(.accentColor)
      }
      .placeDetailsCompactContentSlot(position: .basicSectionBottom) { place in
        VStack(alignment: .leading, spacing: 4) {
          Text("AI Notes")
            .font(.caption)
            .bold()
          Text("Great quiet atmosphere for morning meetings. Famous for house-roasted pour-overs.")
            .font(.footnote)
            .foregroundColor(.secondary)
        }
        .padding(8)
        .background(Color(.systemGray6))
        .cornerRadius(8)
      }
    }
}