HOME BLOG
 

MAPAS API

Classe SAPO.Maps.Geocoder

As instâncias desta classe obtêm coordenadas a partir de endereços.

 
Construtor
Construtor Descrição

SAPO.Maps.Geocoder

Cria uma nova instância do geocoder para obter coordenadas a partir de endereços.

Métodos

Método

Retorno

Descrição

getLocations(query:String, onCompleteCallback:function, onErrorCallback:function,
opts?:Object)

void

Inicia um novo pedido de geocode para dada query. Caso o pedido seja efectuado com sucesso, é notificado o callback correspondente sendo-lhe passado um array de SAPO.Maps.Poi, em caso de erro no acesso ao servidor, é notificado o callback de erro.
As opções são especificadas num objecto, cujas chaves são:

  • bbox:OpenLayers.Bounds: Especifica a área da procura;
  • resultsPerPage:Integer: O número de resultados a receber por página. Por omissão é 10.
  • pageNumber:Integer: O número da página para efectuar o pedido.
  • context:Object: Um objecto de contexto que será passado aos dois callbacks como último parâmetro.
  • searchForPOIS:Boolean: Se true, apenas devolve POIS. Por omissão é false.
  • searchForStreetsAndLocations:Boolean: Se true, apenas devolve Ruas e localidades. Por omissão é false.

getLocationsCategorized(query:String, onCompleteCallback:function, onErrorCallback:function,
opts?:Object)

void

Inicia um novo pedido de geocode para dada query de forma a obter os resultados de forma categorizada. Caso o pedido seja efectuado com sucesso, é notificado o callback correspondente sendo-lhe passado um array de SAPO.Maps.Poi, em caso de erro no acesso ao servidor, é notificado o callback de erro.
As opções são especificadas num objecto, cujas chaves são:

  • bbox:OpenLayers.Bounds: Especifica a área da procura;
  • resultsPerPage:Integer: O número de resultados a receber por página. Por omissão é 10.
  • pageNumber:Integer: O número da página para efectuar o pedido.
  • context:Object: Um objecto de contexto que será passado aos dois callbacks como último parâmetro.
  • searchForPOIS:Boolean: Se true, apenas devolve POIS. Por omissão é false.
  • searchForStreetsAndLocations:Boolean: Se true, apenas devolve ruas e localidades. Por omissão é false.
  • category:String: O nome da categoria da qual se querem obter POIs. Se for omitido, serão retornados POIs de todas as categorias disponíveis.(desde v1.1)

findWhatsHere(lonlat:OpenLayers.LonLat, zoom:Integer, onCompleteCallback:function, onErrorCallback:function,
opts?:Object)

Nada

Inicia um novo pedido de para encontrar POIs próximos do local passado (lonlat)
As opções são especificadas num objecto, cujas chaves são:

  • context:Object: Um objecto de contexto que será passado aos dois callbacks como último parâmetro.