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

Les résumés de lieux générés par l'IA sont des présentations brèves de 100 caractères maximum, spécifiques à un ID de lieu donné. Ils agrègent de nombreux types de données différents dans une présentation de haut niveau pour aider les utilisateurs à obtenir un aperçu d'un lieu.

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

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

Les résumés de lieux sont compatibles avec Place Details (nouveau), Text Search (nouveau), et Nearby Search (nouveau). Ils sont disponibles pour les types de lieux indiqués dans les types compatibles pour les catégories Culture, Divertissement et loisirs, Boissons et alimentation, Shopping, Services, et Sports.

Les résumés de lieux sont compatibles avec les points d'intérêt dans les langues et régions suivantes :

Langue Région
Anglais

Inde

États-Unis

Demander un résumé de lieu généré

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

  • Place Details (nouveau) : generativeSummary
  • Text Search (nouveau) et Nearby Search (nouveau) : places.generativeSummary

Le 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 de divulgation "Résumé généré avec Gemini", qui doit être intégré aux attributions.

Requête Place Details (nouveau)

La requête Place Details (nouveau) suivante renvoie un résumé overview pour un restaurant de sushis à Chicago, dans l'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 comme suit :

{
  "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 (nouveau)

La requête Text Search (nouveau) suivante renvoie un résumé 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 comme suit :

{
  "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 Nearby Search (nouveau) suivante renvoie un résumé overview pour les restaurants et les cafés à Portland, dans l'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 comme suit :

{
  "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 généré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.