Ringkasan tempat yang didukung AI

Ringkasan tempat yang didukung AI adalah ringkasan singkat 100 karakter yang spesifik untuk ID tempat tertentu. Ringkasan tempat menggabungkan berbagai jenis data ke dalam ringkasan tingkat tinggi untuk membantu pengguna mendapatkan ringkasan tempat.

Misalnya, ringkasan tempat dapat menyoroti makanan, layanan, atau barang populer yang tersedia untuk dibeli di suatu lokasi:

  • "Tempat makan Forum Shops yang menyajikan hidangan Italia tradisional dalam porsi besar di ruang santai."
  • "Salon bergaya yang menawarkan potong rambut dan pewarnaan, serta blow dry."
  • "Toko besar dengan banyak vendor yang menawarkan berbagai dekorasi, furnitur, dan pakaian vintage."

Ringkasan tempat didukung oleh Place Details (New), Text Search (New), dan Nearby Search (New). Ringkasan tempat tersedia untuk jenis tempat yang ditampilkan di Jenis yang didukung untuk kategori Budaya, Hiburan dan Rekreasi, Makanan dan Minuman, Shopping, Layanan, dan Olahraga.

Meminta ringkasan tempat generatif

Untuk menampilkan ringkasan tempat dalam respons, sertakan kolom berikut dalam mask kolom dari permintaan:

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

Kolom generativeSummary berisi kolom berikut:

  • generativeSummary: Ringkasan tempat.
  • overviewFlagContentUri: Link tempat pengguna dapat melaporkan masalah pada ringkasan tempat.
  • disclosureText: String teks yang dilokalkan dengan teks pengungkapan "Dringkas dengan Gemini" yang harus disertakan dalam atribusi.

Permintaan Place Details (New)

Permintaan Place Details (Baru) berikut menampilkan ringkasan overview untuk restoran sushi di 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"

Responsnya dalam bentuk:

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

Permintaan Text Search (Baru)

Permintaan Text Search (Baru) berikut menampilkan ringkasan overview untuk restoran vegetarian pedas di 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'

Responsnya dalam bentuk:

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

Permintaan Nearby Search (New)

Permintaan Nearby Search (Baru) berikut menampilkan ringkasan overview untuk restoran dan kafe di Portland, OR:

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'

Responsnya dalam bentuk:

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

Atribusi

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