Yapay zeka destekli yorum özetleri

Yapay zeka destekli yorum özetleri, yalnızca kullanıcı yorumlarına dayalı olarak yerlerin yapay zeka tarafından oluşturulan özetleridir. Yorum özetleri, kullanıcı yorumlarındaki önemli unsurları (ör. yer özellikleri ve yorumcu duygusu) sentezleyerek üst düzey analizler sunar ve kullanıcıların bilinçli kararlar vermesine yardımcı olur.

Örneğin, San Francisco'daki Ferry Building'in yorum özetinde yemek ve alışverişten manzaralara ve atmosfere kadar çeşitli bilgiler yer alır:

"Ziyaretçiler, bu tarihi yapının çeşitli mağazalar, restoranlar ve bir üretici pazarı sunduğunu, ayrıca koy ve şehir manzaralarını övdüklerini belirtiyor. Ayrıca canlı atmosferi, diğer yerlere kolay feribot erişimini ve yerel işletmelerden yararlanma fırsatını da vurguluyorlar."

Yorum özetleri; Yer Ayrıntıları (Yeni), Metin Arama (Yeni) ve Yakınlardaki Arama (Yeni)'da desteklenir.

Yorum özetleri, aşağıdaki dillerde ve bölgelerde ilgi çekici yerler için desteklenir:

Dil Bölge
İngilizce

Hindistan

Japonya

Birleşik Krallık

Amerika Birleşik Devletleri
Japonca Japonya

İnceleme özeti isteğinde bulunma

İnceleme özeti isteğinde bulunmak için isteğin alan maskesine reviewSummary ekleyin:

  • Yer Ayrıntıları (Yeni): reviewSummary
  • Metin Arama (Yeni) ve Yakınlarda Arama (Yeni): places.reviewSummary

Yorum özetinin ilişkilendirmeleri, Google Haritalar'daki yer yorumlarına bağlantı içermelidir. Bu bağlantıyı almak için isteğin alan maskesine reviewSummary.reviewsUri ekleyin.

Yanıt gövdesinde üç alan bulunur:

  • text: Yapay zekayla üretilen yorum özeti.
  • flagContentUri: Uygunsuz içerikleri Google tarafından kaldırılmak üzere işaretlemek için kullanılır.
  • disclosureText: Atıflara dahil edilmesi gereken, "Gemini ile özetlendi" açıklama metnini içeren yerelleştirilmiş bir metin dizesi.

Yer Ayrıntıları (Yeni) isteği

Aşağıdaki örnekte, New York'taki bir mantı restoranı için yorum özeti isteniyor:

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"

Yanıt şu biçimdedir:

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

Metin Arama (Yeni) isteği

Aşağıdaki örnekte, New York City'deki bir kafe için yorum özeti isteniyor:

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'

Yanıt metni şu biçimdedir:

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

Yakında Arama (Yeni) isteği

Aşağıdaki örnekte Seattle şehir merkezinin yakınındaki oteller istenmektedir:

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'

Yanıt şu biçimdedir:

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

İlişkilendirmeler

Uygulamanızda gösterilen tüm yapay zeka destekli özetlere, Google'ın politikaları ve standartları uyarınca uygun atıf eklenmelidir. Daha fazla bilgi için Places API Politikaları'nı inceleyin.