Aller au contenu principal

Local Search

StableÉ.-U. 🇺🇸 et Canada 🇨🇦

Description​

Le widget Local Search aide les acheteurs de propriétés à trouver une propriété à vendre dont l'emplacement correspond le mieux à leur style de vie.

Comment ça fonctionne​

Sur une page comportant plusieurs inscriptions de propriétés (par exemple, sur une page de résultats de recherche d'inscriptions), chaque inscription reçoit un pointage selon les caractéristiques de localisation recherchées par l'utilisateur. Local Search comporte donc deux composantes :

  • Le sélecteur de pointage, qui permet aux utilisateurs de choisir les pointages de localisation qui comptent pour eux
  • Les badges de pointage d'inscription, qui apparaissent sur chaque inscription de propriété

Sélecteur de pointage​

Capture d'écran d'un exemple de sélecteur de pointage

Cet exemple représente l'affichage grid pour le sélecteur de pointage.

Badges de pointage​

<span
  class="ll-match-score"
  data-id="mls2039582"
  data-lat="45.5017"
  data-lng="-73.5656"
>
</span>

Pour que Local Search fonctionne, vous devez ajouter un badge de pointage sur chaque inscription de votre page de résultats de recherche, avec un maximum de 35 par recherche. Chaque badge de pointage doit comporter :

  • Un attribut class avec la valeur ll-match-score.
  • Un attribut data-id avec une valeur unique par inscription. Nous vous suggérons d'utiliser l'ID MLS de l'inscription ou quelque chose de similaire.
  • Un attribut data-lat avec la valeur de latitude de l'emplacement de l'inscription.
  • Un attribut data-lng avec la valeur de longitude de l'emplacement de l'inscription.

Exemple​

<!DOCTYPE html>
<html>
  <head>
    <meta name="viewport" content="initial-scale=1.0" />
    <meta charset="utf-8" />
    <title>Local Logic - Local Search Example</title>
  </head>
  <body>
    <div id="local-search"></div>

    <span
      class="ll-match-score"
      data-id="mls-1"
      data-lat="45.653578"
      data-lng="-73.636561"
    ></span>
    <span
      class="ll-match-score"
      data-id="mls-2"
      data-lat="45.501732"
      data-lng="-73.575345"
    ></span>
    <span
      class="ll-match-score"
      data-id="mls-3"
      data-lat="45.499683"
      data-lng="-73.565832"
    ></span>

    <script type="text/javascript">
      function initLocallogic() {
        var searchWidget = new locallogic.LocalSearch("local-search", {
          displayAs: "grid",
          locale: "fr",
          color: "#017f8f",
        });
      }
    </script>

    <script
      async
      defer
      src="https://cdn.locallogic.co/sdk/?token={YOUR_TOKEN}&callback=initLocallogic"
    ></script>
  </body>
</html>
info

Pour tester cet exemple en direct, assurez-vous de remplacer le paramètre fictif {YOUR_TOKEN} par le jeton que nous vous avons fourni.

Options​

Tableau ici

ParameterStatusDescription
displayAsoptionnelValeur de chaîne qui précise comment l'interface du sélecteur de pointage doit être affichée.
Disponible : list, grid
Par défaut : list
localeoptionnelValeur de chaîne qui précise la langue de l'interface utilisateur.
Disponible : fr (français), en (anglais).
Par défaut : en
coloroptionnelValeur hexadécimale de la couleur principale.
Par défaut : #017f8f
disableCookieoptionnelValeur booléenne qui précise si les utilisateurs verront toujours leur Lifestyle Match personnalisé, même lorsque la page est actualisée ou que les résultats de recherche sont différents. Pour que cela fonctionne, la sélection des caractéristiques de localisation de l'utilisateur est enregistrée dans un témoin. Réglez cette option à true si vous souhaitez désactiver cette fonctionnalité.
Par défaut : false

Méthodes​

isReady ()​

Retourne un booléen. N'appelez aucune autre méthode à moins que ce ne soit vrai.

searchWidget.isReady();

match (scoresArray)​

Met à jour tous les badges de pointage sur la page avec un pointage Lifestyle Match qui reflète la combinaison précisée de caractéristiques de localisation.

searchWidget.match(["transit_friendly", "groceries", "quiet"]);

categories ()​

Retourne un tableau de catégories, contenant des tableaux des caractéristiques de style de vie disponibles

searchWidget.categories();
> [{title: "transportation",
  scores: ["pedestrian_friendly", "transit_friendly", "car_friendly"]},
 {title: "services",
  scores: ["groceries", "primary_schools", "high_schools", "daycares", "restaurants", "cafes", "nightlife", "shopping"]},
 {title: "character",
  scores: ["quiet", "vibrant"]}]

selectionAdd (scoreString)​

Ajoute une seule caractéristique de style de vie à la sélection actuelle

searchWidget.selectionAdd("cafes");

selectionRemove (scoreString)​

Retire une seule caractéristique de style de vie des pointages actuellement affichés sur la carte

searchWidget.selectionRemove("groceries");

selection ()​

Retourne un tableau des caractéristiques de style de vie actuellement sélectionnées

searchWidget.selection();
> ["pedestrian_friendly", "cafes", "quiet"]

selectionHas (scoreString)​

Retourne un booléen indiquant si la caractéristique de style de vie précisée fait partie de la sélection actuelle ou non

searchWidget.selectionHas("groceries");

reloadLocations ()​

Recharge tous les badges de pointage associés aux emplacements sur votre page. Cette méthode est utile si votre page comporte un chargeur asynchrone.

searchWidget.reloadLocations();

disable ()​

Désactive le Lifestyle Match

searchWidget.disable();

enable ()​

Active le Lifestyle Match

searchWidget.enable();

isEnable ()​

Retourne un booléen indiquant si le Lifestyle Match est activé ou non

searchWidget.isEnable();