Riepiloghi dei luoghi basati sull'IA

I riepiloghi dei luoghi basati sull'AI sono brevi panoramiche di 100 caratteri specifiche per un ID luogo. I riepiloghi dei luoghi aggregano molti tipi diversi di dati in una panoramica di alto livello per aiutare gli utenti a ottenere un'istantanea di un luogo.

Ad esempio, i riepiloghi dei luoghi possono mettere in evidenza cibi, servizi o prodotti popolari disponibili per l'acquisto in una località:

  • "Ristorante del Forum Shops che serve abbondanti porzioni di piatti tradizionali italiani in un ambiente informale."
  • "Elegante salone che offre tagli e colorazioni, oltre a pieghe."
  • "Grande negozio con molti venditori che offrono una varietà di decorazioni, mobili e abiti vintage."

I riepiloghi dei luoghi sono supportati da Place Details (New), Ricerca testuale (New) e Nearby Search (New). I riepiloghi dei luoghi sono disponibili per i tipi di luoghi mostrati in Tipi supportati per le categorie Cultura, Intrattenimento e svago, Mangiare e bere, Shopping, Servizi e Sport.

I riepiloghi dei luoghi sono supportati per i punti d'interesse nelle seguenti lingue e regioni:

Lingua Regione
Inglese

India

Stati Uniti

Richiedere un riepilogo generativo del luogo

Per restituire un riepilogo del luogo nella risposta, includi il seguente campo nella maschera del campo della richiesta:

  • Dettagli del luogo (nuovo): generativeSummary
  • Ricerca testuale (novità) e Nearby Search (novità): places.generativeSummary

Il campo generativeSummary contiene i seguenti campi:

  • generativeSummary: Il riepilogo del luogo.
  • overviewFlagContentUri: Un link in cui gli utenti possono segnalare un problema con il riepilogo del luogo.
  • disclosureText: una stringa di testo localizzata con il testo dell'informativa "Riepilogo creato con Gemini" che deve essere incorporata nelle attribuzioni.

Richiesta Place Details (novità)

La seguente richiesta di Place Details (New) restituisce un riepilogo overview per un ristorante di sushi a Chicago, IL:

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 risposta è nel formato:

{
  "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"
    }
  }
}

Richiesta di ricerca testuale (nuova)

La seguente richiesta di Ricerca testuale (New) restituisce un riepilogo overview per ristoranti vegetariani piccanti a Mountain View, CA:

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 risposta è nel formato:

{
  "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"
        }
      }
    },
    /.../
  ]
}

Richiesta Nearby Search (New)

La seguente richiesta di Nearby Search (nuova) restituisce un overviewriepilogo per ristoranti e caffè a 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 risposta è nel formato:

{
  "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"
        }
      }
    },
    /.../
  ]
}

Attribuzioni

Tutti i riepiloghi basati sull'AI visualizzati nella tua app devono essere accompagnati dall'attribuzione appropriata in conformità con le norme e gli standard di Google. Per maggiori informazioni, consulta le norme per l'API Places.