Pular para o conteúdo
Wink

Geolocalização

O Wink utiliza geolocalização extensivamente para potenciar a pesquisa baseada na localização, deteção automática de moeda e idioma, e filtragem geográfica do inventário.

Deteção GeoIP

Seção intitulada “Deteção GeoIP”

Quando um utilizador visita a plataforma, o Wink deteta automaticamente a sua localização com base no endereço IP. Isto permite:

  • Seleção automática de moeda — Exibir preços na moeda local do utilizador.
  • Preferência de idioma — Sugerir conteúdo no idioma provável do utilizador.
  • Resultados próximos — Priorizar inventário próximo da localização do utilizador.

Pesquisa espacial

Seção intitulada “Pesquisa espacial”

O Wink suporta pesquisa geográfica usando quatro tipos de consultas espaciais. Estas alimentam a pesquisa baseada em mapas, pesquisa por raio e filtragem por área em toda a plataforma.

Ponto

Seção intitulada “Ponto”

Uma coordenada geográfica única (latitude, longitude). Usada para marcar uma localização específica — por exemplo, o endereço de uma propriedade ou a localização atual de um utilizador.

{
  "point": {
    "x": -73.9857,
    "y": 40.7484
  }
}

Círculo

Seção intitulada “Círculo”

Um ponto central com um raio. Usado para consultas “pesquisar perto de mim” ou baseadas em raio — por exemplo, “hotéis a menos de 10 km da Times Square.”

{
  "point": {
    "x": -73.9857,
    "y": 40.7484
  },
  "radius": 10000
}

Retângulo

Seção intitulada “Retângulo”

Uma caixa delimitadora definida pelos cantos sudoeste e nordeste. Usado para pesquisa baseada em mapas — quando um utilizador move e amplia um mapa, a área visível define uma consulta retangular.

{
  "southWest": {
    "x": -74.0060,
    "y": 40.7128
  },
  "northEast": {
    "x": -73.9350,
    "y": 40.7831
  }
}

Polígono

Seção intitulada “Polígono”

Uma forma personalizada definida por uma série de pontos. Usado para pesquisar dentro de limites geográficos irregulares — por exemplo, um bairro, um distrito da cidade ou uma área desenhada manualmente num mapa.

{
  "polygon": {
    "points": [
      { "x": -74.0060, "y": 40.7128 },
      { "x": -73.9350, "y": 40.7128 },
      { "x": -73.9350, "y": 40.7831 },
      { "x": -74.0060, "y": 40.7831 },
      { "x": -74.0060, "y": 40.7128 }
    ]
  }
}

Casos de uso

Seção intitulada “Casos de uso”
Caso de usoTipo de formaExemplo
Pesquisar perto de mimCírculoHotéis a menos de 5 km da minha localização
Pesquisa na área visível do mapaRetânguloPropriedades visíveis na vista atual do mapa
Pesquisa por bairroPolígonoHotéis num distrito específico da cidade
Localização da propriedadePontoLocalização exata de um anúncio de propriedade

Para desenvolvedores

Seção intitulada “Para desenvolvedores”

Os parâmetros de consulta espacial são aceites pelos endpoints da Lookup API e Inventory API. Envie a forma GeoJSON apropriada na sua requisição de pesquisa para filtrar resultados por localização.

Consulte a documentação das APIs para detalhes específicos de cada endpoint.

Leitura adicional

Seção intitulada “Leitura adicional”