Riepiloghi dei luoghi basati sull'IA

I riepiloghi dei luoghi basati sull'AI sono brevi panoramiche di 100 caratteri specifiche per un determinato 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 evidenziare cibi, servizi o beni popolari disponibili per l'acquisto in una località:

  • "Ristorante del Forum Shops che serve grandi 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), Text Search (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 attività ricreative, Cibi e bevande, Shopping, Servizi e Sport.

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

Lingua Regione
Inglese

India

Stati Uniti

Richiedere un riepilogo generativo di un luogo

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

  • Place Details (New): generativeSummary
  • Ricerca di testo (novità) e Ricerca nelle vicinanze (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 "Riassunto con Gemini" che deve essere incorporato nelle attribuzioni.

Richiesta Place Details (New)

La seguente richiesta 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 di testo (nuova) 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 di ricerca nelle vicinanze (nuova)

La seguente richiesta di ricerca nelle vicinanze (nuova) restituisce un riepilogo overview 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.