Ringkasan ulasan yang didukung AI

Ringkasan ulasan yang didukung AI adalah ringkasan tempat yang dibuat AI berdasarkan ulasan pengguna saja. Dengan menggabungkan elemen utama ulasan pengguna, seperti atribut tempat dan sentimen pengulas, ringkasan ulasan memberikan insight tingkat tinggi dan membantu pengguna membuat keputusan yang tepat.

Misalnya, ringkasan ulasan Ferry Building di San Francisco mencakup informasi mulai dari makanan dan belanja hingga pemandangan dan suasana:

"Pengunjung mengatakan bahwa landmark bersejarah ini menawarkan beragam pilihan toko, restoran, dan pasar petani, dengan banyak yang memuji pemandangan teluk dan kota. Mereka juga menyoroti suasana yang ramai, akses feri yang mudah ke tujuan lain, dan peluang untuk menikmati bisnis lokal."

Ringkasan ulasan didukung di Place Details (Baru), Text Search (Baru), dan Nearby Search (Baru).

Ringkasan ulasan didukung untuk tempat menarik dalam bahasa dan wilayah berikut:

Language Region
Inggris Argentina, Bolivia, Brasil, Chili, Kolombia, Kosta Rika, Republik Dominika Ekuador, Guatemala, India, Jepang, Meksiko, Paraguay, Peru, Inggris Raya, Amerika Serikat, Uruguay, Venezuela
Jepang Jepang
Portugis Brasil
Spanyol Argentina, Bolivia, Chili, Kolombia, Kosta Rika, Republik Dominika, Ekuador, Guatemala, Meksiko, Paraguay, Peru, Amerika Serikat, Uruguay, Venezuela

Meminta ringkasan ulasan

Untuk meminta ringkasan ulasan, sertakan reviewSummary di mask kolom permintaan:

  • Place Details (Baru): reviewSummary
  • Text Search (Baru) dan Nearby Search (Baru): places.reviewSummary

Atribusi untuk ringkasan ulasan harus menyertakan link ke ulasan tempat di Google Maps. Untuk mengambil link tersebut, sertakan reviewSummary.reviewsUri di mask kolom permintaan.

Isi respons mencakup tiga kolom:

  • text: Ringkasan ulasan yang dibuat AI.
  • flagContentUri: Digunakan untuk menandai konten yang tidak pantas agar dihapus oleh Google.
  • disclosureText: String teks yang dilokalkan dengan teks pengungkapan "Dirangkum dengan Gemini" yang harus disertakan dalam atribusi.

Permintaan Place Details (Baru)

Contoh berikut meminta ringkasan ulasan untuk restoran pangsit di New York:

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

Responsnya dalam bentuk:

{
  "displayName": {
    "text": "Dumpling House",
    "languageCode": "en"
  },
  "reviewSummary": {
    "text": {
      "text": "People say this restaurant serves delicious dumplings, noodles, and pork belly buns. They highlight the generous portions, reasonable prices, and quick service. They also like the friendly and accommodating staff.",
      "languageCode": "en-US"
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEE%7CCAIQACorChtyc19oOnNwOUFtUVhIX1BoTEZjTFg0MmNXNEESDAikt7HDBhDopLLxAg&d=17924085&t=8",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    },
    "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89d14bb69376690f:0x53d61573fb1dcd0b!9m1!1b1"
  }
}

Permintaan Text Search (Baru)

Contoh berikut meminta ringkasan ulasan untuk kedai kopi di New York City:

curl -X POST -d '{
  "textQuery": "coffee shop",
  "locationBias": {
    "circle": {
      "center": {
        "latitude": 40.722630,
        "longitude": -74.001397
      }
    }
  },
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.reviewSummary" \
'https://places.googleapis.com/v1/places:searchText'

Isi respons dalam bentuk:

{
  "places": [
    {
      "id": "ChIJyfJXNphZwokRbo-oe0DjVT4",
      "reviewSummary": {
        "text": {
          "text": "People say this coffee shop serves up delicious oat milk lattes, cold brew, and pastries, such as almond croissants and cheese danish. They also highlight the friendly staff, cozy atmosphere, and outdoor seating.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFE%7CCAIQACorChtyc19oOkk1Z1UwZkp4cEJ3bnA3aGt5VGJLMFESDAj7p9_BBhCYsoeAAw&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c259983657f2c9:0x3e55e3407ba88f6e!9m1!1b1"
      }
    },
    {
      "id": "ChIJHcFFXH9ZwokR_QKedPacLiQ",
      "reviewSummary": {
        "text": {
          "text": "People say this cafe offers delicious matcha, lattes, and freshly baked pastries, including the popular rose honey latte and blueberry lemon muffin. They highlight the spacious, chill, and cinema-inspired vibe, perfect for working or socializing, and the fast, friendly service. They also like the free WiFi, outlets, and clean restrooms.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelE%7CCAIQACorChtyc19oOl8yWTlXS0NDVTk1UEhiTFdBQzhlelESDAikt7HDBhDopLLxAg&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x89c2597f5c45c11d:0x242e9cf6749e02fd!9m1!1b1"
      }
    },
    ...
  ]
}

Permintaan Nearby Search (Baru)

Contoh berikut meminta hotel di dekat pusat kota Seattle:

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

Responsnya dalam bentuk:

{
  "places": [
    {
      "id": "ChIJRwVmS-BrkFQRpAB3pO5JOuQ",
      "reviewSummary": {
        "text": {
          "text": "People say this hotel offers clean, modern, and spacious rooms with comfortable beds and phenomenal city views. They highlight the convenient downtown location, with easy walking access to popular attractions, and the efficient self-parking option. They also like the friendly and helpful staff, and the smooth check-in and check-out process.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOlJWVG5YOXZrSnZhTXBqUy1rc1JZc3c%7CCAIQACorChtyc19oOlJWVG5YOXZrSnZhTXBqUy1rc1JZc3cSDAikt7HDBhDopLLxAg&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906be04b660547:0xe43a49eea47700a4!9m1!1b1"
      }
    },
    {
      "id": "ChIJQVJVX7RqkFQRcpsm3VVub9U",
      "reviewSummary": {
        "text": {
          "text": "People say this hotel offers spacious rooms, a convenient location near the convention center and Pike Place Market, and a tasty restaurant. They also highlight the friendly and attentive staff, the comfortable beds and pillows, and the convenient amenities such as a Starbucks in the lobby and a club lounge.\n\nSome reviews mention the rooms can be noisy.",
          "languageCode": "en-US"
        },
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=5%401:CAIQACodChtyc19oOldJVUlodGhTUTJOdUdTSmFxQWw2Nnc%7CCAIQACorChtyc19oOldJVUlodGhTUTJOdUdTSmFxQWw2NncSDAikt7HDBhDopLLxAg&d=17924085&t=8",
        "disclosureText": {
          "text": "Summarized with Gemini",
          "languageCode": "en-US"
        },
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x54906ab45f555241:0xd56f6e55dd269b72!9m1!1b1"
      }
    },
    ...
  ]
}

Atribusi

Semua ringkasan yang didukung AI yang ditampilkan di aplikasi Anda harus disertai atribusi yang sesuai sesuai dengan kebijakan dan standar Google. Untuk mengetahui informasi selengkapnya, lihat Kebijakan untuk Places API.