google_places_autocomplete_text_field

Visão geral do pacote

Orientação gerada a partir de informações públicas. Apenas para referência.

Um campo de texto personalizável do Flutter para autocomplete de locais do Google, com suporte a plataformas iOS, Android e web. Permite que os usuários pesquisem e selecionem localizações com sugestões em tempo real fornecidas pela API do Google Places. O widget foi projetado para integração perfeita em formulários que exigem entrada de endereço ou localização, oferecendo flexibilidade em estilo e comportamento. Ideal para aplicativos que precisam de dados de geolocalização precisos a partir de endereços inseridos pelos usuários.

Casos de uso

Entrada de endereço em formulários
Seleção de localização em aplicativos de viagem
Entrada de endereço de entrega
Serviços baseados em geolocalização
Configuração do perfil do usuário

Principais recursos

Sugestões de local em tempo real
UI e estilização personalizáveis
Suporte multiplataforma (iOS, Android, Web)
Integração com a API do Google Places
Tratamento e validação de erros embutidos

Indicado para

Aplicativos móveis e web que exigem entrada de localização
Aplicativos com recursos de entrega ou mapeamento
Formulários que exigem entrada precisa de endereço
Desenvolvedores usando a API do Google Places
Projetos com prioridade para UX com autocomplete

Considerações

Requer chave da API do Google Places
Pode incorrer em custos de uso com base nas consultas
Depende da conectividade de internet
Personalização limitada da aparência da lista de sugestões
Latência potencial no tempo de resposta durante alta carga

README original

Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.

This Flutter package helps you build a TextField that provides autocompletion suggestions from the new Google Places API.

Go check it out on pub.dev!

Add the dependency to pubspec.yml ➕

dependencies:
  flutter:
    sdk: flutter
  google_places_autocomplete_text_field: <last-version>

Integrate the Google AutoComplete TextField Widget in your code 🧩

    GooglePlacesAutoCompleteTextFormField(
        textEditingController: controller,
        config: const GoogleApiConfig(
          apiKey: 'YOUR_GOOGLE_API_KEY',
          // only needed if you build for the web
          proxyURL: 'https://your-proxy.com/',
          countries: ['de'], // optional, by default the list is empty (no restrictions)
          fetchPlaceDetailsWithCoordinates: true,  // if you require the coordinates from the place details
          debounceTime: 400, // defaults to 600 ms
          locationRestriction: LocationConfig.circle(
            circleCenter: const Coordinates(latitude: 52.5200, longitude: 13.4050),
            circleRadiusInKilometers: 1000,
          ), // either this or locationBias (or nothing)
          placeTypeRestriction: PlaceType.city, // if you want specific place types
        ),
        onPredictionWithCoordinatesReceived: (prediction) {
         // this method will return latlng with place detail
        print("Coordinates: (${prediction.lat},${prediction.lng})");
        // the place details are returned on the prediction as well
        print("Address: ${prediction.formattedAddress}");
        print("Components: ${prediction.addressComponents}");
        }, // this callback is called when fetchPlaceDetailsWithCoordinates is true
        onSuggestionClicked: (prediction) {
         controller.text = prediction.description;
          controller.selection = TextSelection.fromPosition(TextPosition(offset: prediction.description.length));
        }
    )

Integrate the Google AutoComplete TextField Widget in your Web code 🌐

In case you're building for the web, you need to pass the widget a proxy URL, otherwise you will receive a CORS-Error, as there are calls to the Google Maps API being made from the frontend. If you are not Google, your domain will probably be different, thus leading to the CORS-Error. If you are Google: how ya doin 😏? I'd love to do an internship.

Customization Option

You can customize the GooglePlacesAutoCompleteTextFormField as you would with any other TextFormField.

Buscar pacotes, repositórios e categorias de apps