Places Widgets

Classe de preenchimento automático

Classe google.maps.places.Autocomplete

Um widget que fornece previsões do Place com base na entrada de texto de um usuário. Ele é anexado a um elemento de entrada do tipo text e detecta entrada de texto nesse campo. A lista de previsões é apresentada como uma lista suspensa e é atualizada à medida que o texto é inserido.

Essa classe estende MVCObject.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

Autocomplete
Autocomplete(inputField[, opts])
Parâmetros:
Cria uma nova instância de Autocomplete que é anexada ao campo de texto de entrada especificado com as opções fornecidas.
getBounds
getBounds()
Parâmetros:nenhum
Valor de retorno:LatLngBounds|undefined Os limites de viés.
Retorna os limites em que as previsões são tendenciosas.
getFields
getFields()
Parâmetros: nenhum
Valor de retorno: Array<string>|undefined
Retorna os campos a serem incluídos para o local na resposta de detalhes quando os detalhes forem recuperados. Para uma lista de campos, consulte PlaceResult.
getPlace
getPlace()
Parâmetros: nenhum
Valor de retorno: PlaceResult o lugar selecionado pelo usuário.
Retornará os detalhes do lugar selecionado pelo usuário se os detalhes tiverem sido recuperados. Caso contrário, retorna um objeto de stub do lugar, com a propriedade name definida como o valor atual do campo de entrada.
setBounds
setBounds(bounds)
Parâmetros:
Valor de retorno: nenhum
Define a área preferida para retornar os resultados de lugar. Os resultados são direcionados, mas não restritos, a essa área.
setComponentRestrictions
setComponentRestrictions(restrictions)
Parâmetros:
Valor de retorno: nenhum
Define as restrições do componente. As restrições de componentes são usadas para restringir as previsões apenas àquelas dentro do componente pai. Por exemplo, o país.
setFields
setFields(fields)
Parâmetros:
  • fieldsArray<string> optional
Valor de retorno:nenhum
Define os campos a serem incluídos para o local na resposta de detalhes quando os detalhes forem recuperados. Para uma lista de campos, consulte PlaceResult.
setOptions
setOptions(options)
Parâmetros:
Valor de retorno: nenhum
setTypes
setTypes(types)
Parâmetros:
  • typesArray<string> optional os tipos de previsão que serão incluídas.
Valor de retorno: nenhum
Define os tipos de previsões a serem retornadas. Para tipos compatíveis, consulte o Guia do desenvolvedor. Se nenhum tipo for especificado, todos os tipos serão retornados.
Herdados: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
place_changed
function()
Argumentos:  nenhum
Este evento é disparado quando há um PlaceResult disponibilizado para um local selecionado pelo usuário.
Se o usuário inserir o nome de um lugar que não foi sugerido pelo controle e pressionar a tecla Enter ou se uma solicitação do Place Details falhar, o PlaceResult conterá a entrada do usuário na propriedade name, sem outras propriedades definidas.

Interface AutocompleteOptions

Interface google.maps.places.AutocompleteOptions

As opções que podem ser definidas em um objeto Autocomplete.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

bounds optional
A área em que os lugares serão pesquisados.
componentRestrictions optional
Tipo:ComponentRestrictions optional
As restrições dos componentes. As restrições de componentes são usadas para restringir as previsões apenas àquelas dentro do componente pai. Por exemplo, o país.
fields optional
Tipo:Array<string> optional
Campos a serem incluídos para o local na resposta de detalhes quando os detalhes forem recuperados, que serão cobrados. Se ['ALL'] for transmitido, todos os campos disponíveis serão retornados e cobrados. Isso não é recomendado para implantações de produção. Para uma lista de campos, consulte PlaceResult. Os campos aninhados podem ser especificados com caminhos de ponto (por exemplo, "geometry.location"). O padrão é ['ALL'].
placeIdOnly optional
Tipo: boolean optional
Define se apenas IDs de local serão recuperados. O PlaceResult disponibilizado quando o evento place_Changed será disparado terá apenas o place_id, os tipos e os campos de nome, com o place_id, os tipos e a descrição retornados pelo serviço Autocomplete. Desativado por padrão.
strictBounds optional
Tipo: boolean optional
Um valor booleano, indicando que o widget de preenchimento automático deve retornar apenas os lugares que estão dentro dos limites do widget no momento em que a consulta é enviada. Definir strictBounds como false (o padrão) fará com que os resultados sejam enviesados para lugares contidos nos limites, mas não restritos
types optional
Tipo:Array<string> optional
Os tipos de previsão a serem retornados. Para tipos compatíveis, consulte o Guia do desenvolvedor. Se nenhum tipo for especificado, todos os tipos serão retornados.

Classe google.maps.places.SearchBox

Um widget que fornece previsões de consulta com base na entrada de texto de um usuário. Ele é anexado a um elemento de entrada do tipo text e detecta entrada de texto nesse campo. A lista de previsões é apresentada como uma lista suspensa e é atualizada à medida que o texto é inserido.

Essa classe estende MVCObject.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

SearchBox
SearchBox(inputField[, opts])
Parâmetros:
Cria uma nova instância de SearchBox que é anexada ao campo de texto de entrada especificado com as opções fornecidas.
getBounds
getBounds()
Parâmetros: nenhum
Valor de retorno:LatLngBounds|undefined
Retorna os limites em que as previsões de consulta são tendenciosas.
getPlaces
getPlaces()
Parâmetros:nenhum
Valor de retorno:Array<PlaceResult>|undefined
Retorna a consulta selecionada pelo usuário a ser usada com o evento places_changed.
setBounds
setBounds(bounds)
Parâmetros:
Valor de retorno:nenhum
Define a região a ser usada para influenciar as previsões de consulta. Os resultados serão direcionados apenas para essa área e não serão completamente restritos a ela.
Herdados: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
places_changed
function()
Argumentos:  nenhum
Este evento é disparado quando o usuário seleciona uma consulta. O getPlaces precisa ser usado para buscar novos lugares.

Interface SearchBoxOptions

Interface google.maps.places.SearchBoxOptions

As opções que podem ser definidas em um objeto SearchBox.

Requer o parâmetro de URL &libraries=places. Consulte Bibliotecas na API Maps JavaScript.

bounds optional
A área a que as previsões de consulta devem ser direcionadas. As previsões são tendenciosas em relação a consultas segmentadas para esses limites, mas não se limitando a elas.