Résumés de lieux optimisés par l'IA

Les résumés de lieux optimisés par l'IA sont des aperçus courts de 100 caractères spécifiques à un ID de lieu donné. Les récapitulatifs de lieu regroupent de nombreux types de données dans une vue d'ensemble pour aider les utilisateurs à obtenir un aperçu d'un lieu.

Par exemple, les résumés de lieux peuvent mettre en avant des plats, des services ou des produits populaires disponibles à l'achat dans un lieu :

  • "Restaurant des Forum Shops servant de grandes portions de plats italiens traditionnels dans un cadre décontracté."
  • "Salon élégant proposant des coupes de cheveux, des colorations et des brushings."
  • "Grand magasin avec de nombreux vendeurs proposant une variété de décoration, de meubles et de vêtements vintage."

Les résumés de lieu sont compatibles avec Place Details (New), Text Search (New) et Nearby Search (New). Les résumés de lieu sont disponibles pour les types de lieux indiqués dans Types compatibles pour les catégories Culture, Divertissement et loisirs, Alimentation et boissons, Shopping, Services et Sports.

Demander un résumé génératif d'un lieu

Pour renvoyer un résumé de lieu dans la réponse, incluez le champ suivant dans le masque de champ de la requête :

  • Détails du lieu (nouveau) : generativeSummary
  • Text Search (nouvelle version) et Nearby Search (nouvelle version) : places.generativeSummary

Le champ generativeSummary contient les champs suivants :

  • generativeSummary : résumé du lieu.
  • overviewFlagContentUri : lien permettant aux utilisateurs de signaler un problème avec le résumé du lieu.
  • disclosureText : chaîne de texte localisée avec le texte d'information "Résumé avec Gemini" qui doit être intégré aux attributions.

Requête Place Details (New)

La requête Place Details (New) suivante renvoie un récapitulatif overview pour un restaurant de sushis à Chicago (Illinois) :

curl -X GET https://places.googleapis.com/v1/places/ChIJ1eOF7HLTD4gRry3xPjk8DkU \
-H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: displayName,generativeSummary"

La réponse se présente sous la forme suivante :

{
  "displayName": {
    "text": "Sushi Nova - Lincoln Park",
    "languageCode": "en"
  },
  "generativeSummary": {
    "overview": {
      "text": "Casual eatery with all-you-can-eat sushi and other Japanese fare, plus beer and sake.",
      "languageCode": "en-US"
    },
    "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDg4MGZkMzcyZWM4NWUzZDU6MHg0NTBlM2MzOTNlZjEyZGFmMAI&d=17924085&t=12",
    "disclaimerText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

Requête Text Search (nouvelle version)

La requête Text Search (New) suivante renvoie un récapitulatif overview pour les restaurants végétariens épicés à Mountain View, en Californie :

curl -X  POST -d '{
  "textQuery": "Spicy Vegetarian Food",
  "location_bias": {
    "rectangle": {
      "low": {
        "latitude": 37.415,
        "longitude": -122.091
      },
      "high": {
        "latitude": 37.429,
        "longitude": -122.065
      }
    }
  },
  "maxResultCount": 5
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchText'

La réponse se présente sous la forme suivante :

{
  "places": [
    {
      "id": "ChIJ8wN5kzm3j4AR_dRdUHoqrPI",
      "displayName": {
        "text": "Plant-Based Vegan Vietnamese",
        "languageCode": "en"
      }
    },
    {
      "id": "ChIJw4RuczO3j4ARC7RByZ5K9nI",
      "displayName": {
        "text": "sweetgreen",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering healthy, made-to-order salads, plates, and grain bowls with vegan options.",
          "languageCode": "en-US"
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzMzNzM2ZTg0YzM6MHg3MmY2NGE5ZWM5NDFiNDBiMAI&d=17924085&t=12",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

Requête Nearby Search (nouveau)

La requête de recherche à proximité (nouvelle) suivante renvoie un récapitulatif overview pour les restaurants et les cafés à Portland (Oregon) :

curl -X POST -d '{
  "maxResultCount": 5,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": 45.553360,
        "longitude": -122.674934
        },
      "radius": 1000
    }
  },
  "includedTypes": ["restaurant", "cafe"],
  "excludedTypes": [],
  "rankPreference":"POPULARITY"
  }' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.generativeSummary" \
'https://places.googleapis.com/v1/places:searchNearby'

La réponse se présente sous la forme suivante :

{
  "places": [
    {
      "id": "ChIJOa08KlqnlVQR_ZZx1jEcTYY",
      "generativeSummary": {
        "overview": {
          "text": "BBQ and Thai street fare, plus imaginative tropical cocktails, served in a vibrant space.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJU4OzoWynlVQRxlQMpGenSvA",
      "generativeSummary": {
        "overview": {
          "text": "Beer hall with a big selection of German brews, plus a central courtyard with food trucks.",
          "languageCode": "en-US"
        },
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        }
      }
    },
    /.../
  ]
}

Attributions

Tous les résumés optimisés par l'IA affichés dans votre application doivent être accompagnés de l'attribution appropriée, conformément aux règles et normes de Google. Pour en savoir plus, consultez les Règles concernant l'API Places.