Einfache „Place Autocomplete“-Komponente

Mit der Basic Place Autocomplete-Komponente des Places UI Kit können Sie eine einzelne UI-Komponente hinzufügen, die eine Orts-ID zurückgibt, wenn ein Nutzer einen Ort auswählt. Die Komponente ist eine Vollbildabdeckung, die eine Suchleiste enthält, in die Nutzer eine Anfrage eingeben können. Während der Nutzer tippt, wird unter der Suchleiste eine Liste mit Ergebnissen für die automatische Vervollständigung angezeigt. Wenn der Nutzer auf einen Ort tippt, wird dem Entwickler ein Ortsobjekt mit nur der Orts-ID zurückgegeben. Diese Komponente kann angepasst werden.

Die Komponente verwendet geografische Grenzen und andere Suchparameter über die AutocompleteFilter-Struktur.

Die Antwort enthält eine Place-Struktur, in der nur das Feld placeID ausgefüllt ist.

Die Komponente „Basic Place Autocomplete“ bietet die folgenden Anpassungsoptionen: Listendichte und ob Standort-Symbole enthalten sein sollen. Verwenden Sie die AutocompleteUICustomization-Struktur, um die Komponente anzupassen.

Sie können die Komponente „Basic Place Autocomplete“ unabhängig oder in Verbindung mit anderen APIs und Diensten der Google Maps Platform verwenden.

Abrechnung

Die Abrechnung erfolgt jedes Mal, wenn die Komponente geöffnet und eine Anfrage gestellt wird. Sie werden für diese Sitzung nicht noch einmal abgerechnet, es sei denn, die Sitzung läuft ab oder es wird ein Ort aus der Liste ausgewählt.

Basic Autocomplete-Komponente in Ihre App einfügen

Legen Sie die Autocomplete-Filterparameter fest, z. B. die zurückzugebenden Typen, das Land, auf das die Ergebnisse beschränkt werden sollen, die Regionskoordinaten für die Ergebnisse und die Entfernungsinformationen, wenn der Ausgangspunkt des Nutzers festgelegt ist. Das funktioniert genauso wie bei der Verwendung von Place Autocomplete (New) ohne das Places UI Kit. Eine vollständige Anleitung und ein Beispiel für den Code zum Erstellen eines Filters für die automatische Vervollständigung finden Sie in der Dokumentation zu Place Autocomplete (New).

Nachdem Sie den Filter für die automatische Vervollständigung erstellt haben, können Sie eine Struktur mit Ihren UI-Anpassungen erstellen. Weitere Informationen zu Anpassungsoptionen

Erstellen Sie dann eine Schaltfläche, mit der die angepasste Basic Autocomplete-Komponente gestartet wird.

  Button("Search for a place") {
    showWidget.toggle()
  }
  .basicPlaceAutocomplete(
    show: $showWidget
     // ...
  )

Vollständiges Beispiel ansehen

Komponente für die einfache automatische Vervollständigung anpassen

Kompaktheitsgrad der Liste

Sie können entweder eine zweizeilige oder eine mehrzeilige Liste anzeigen lassen. Verwenden Sie die Optionen in AutocompleteListDensity (.twoLine oder .multiLine) in der Klasse AutocompleteUICustomization. Wenn Sie die Listendichte nicht angeben, wird in der Komponente eine zweizeilige Liste angezeigt.

Standortsymbol

Sie können festlegen, ob in der Ergebnisliste ein Standardsymbol für Orte angezeigt werden soll. Verwenden Sie die Optionen in AutocompleteUIIcon (.defaultIcon oder .noIcon) in der Klasse AutocompleteUICustomization.

Anpassungen an der Basic Autocomplete-Komponente vornehmen

Mit der Klasse AutocompleteUICustomization können Sie die Komponente „Einfache automatische Vervollständigung“ anpassen.

let uiCustomization = AutocompleteUICustomization(
    listDensity: .multiLine,
    listItemIcon: .noIcon,
)

Beispiel

In diesem Beispiel wird eine benutzerdefinierte Basic Autocomplete-Komponente mit einer Schaltfläche erstellt. Das Standardsymbol und die zweizeilige Listendichte sind ausgewählt. Der Filter für die automatische Vervollständigung ist so eingestellt, dass Orte in und in der Nähe von Las Vegas gefunden werden, die mit Buchhaltung in Verbindung stehen.

  // Note: You must provide an API key in your app entry point first.
  // A demo view of the basic place autocomplete widget.
  public struct BasicPlaceAutocompleteView: View {
    @State private var fetchedPlace: Place?
    @State private var placesError: PlacesError?
    @State private var showWidget = false
    public var body: some View {
      let types: Set<PlaceType> = [.accounting]
      let countries: Set<String> = ["US"]
      let origin = CLLocation(latitude: 36.19030535579595, longitude: -115.25397680618019)
      let coordinateRegion = RectangularCoordinateRegion(
        northEast: CLLocationCoordinate2D(
          latitude: 36.25290087640495, longitude: -115.08025549571225),
        southWest: CLLocationCoordinate2D(latitude: 36.06607422287787, longitude: -115.33431432920293)
      )
      let regionCode = "US"
      let inputOffset = 10
      let filter = AutocompleteFilter(
        types: types,
        countries: countries,
        origin: origin,
        coordinateRegionBias: coordinateRegion,
        regionCode: regionCode)
      let uiCustomization = AutocompleteUICustomization(
        listDensity: .multiLine,
        listItemIcon: .noIcon)
      VStack {
        Button("Search for a place") {
          showWidget.toggle()
        }
        .basicPlaceAutocomplete(
          filter: filter,
          uiCustomization: uiCustomization ?? AutocompleteUICustomization(),
          show: $showWidget,
          onSelection: { place in
            guard let placeID = place.placeID else {
              self.placesError = .internal(
                "Could not fetch place details because place ID from selected suggestion not found."
              )
              return
            }
            Task {
              let placesClient = await PlacesClient.shared
              let fetchPlaceRequest = FetchPlaceRequest(
                placeID: placeID,
                placeProperties: [.displayName, .formattedAddress]
              )
              switch await placesClient.fetchPlace(with: fetchPlaceRequest) {
              case .success(let place):
                print("Fetched place: \(place)")
                self.fetchedPlace = place
              case .failure(let placesError):
                print("Failed to fetch place: \(placesError)")
                self.placesError = placesError
              }
            }
          },
          onError: { placesError in
            self.placesError = placesError
          }
        )
        if let placesError = $placesError.wrappedValue {
          Text(placesError.localizedDescription)
            .frame(maxWidth: .infinity, alignment: .leading)
        } else if let fetchedPlace = $fetchedPlace.wrappedValue {
          Text("\(fetchedPlace)")
            .frame(maxWidth: .infinity, alignment: .leading)
        }
      }
    }
  }