Yapay zeka destekli yorum özetleri

Yapay zeka destekli yorum özetleri, yalnızca kullanıcı yorumlarına dayalı olarak yapay zeka tarafından oluşturulan yer özetleridir. Yorum özetleri, kullanıcı yorumlarının temel unsurlarını (ör. yer özellikleri ve yorumcu görüşleri) 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 manzara ve atmosfere kadar çeşitli bilgiler yer alır:

"Ziyaretçiler, bu tarihi simge yapıda çeşitli mağazalar, restoranlar ve çiftçi pazarı bulunduğunu, körfez ve şehir manzarasının çok güzel olduğunu söylüyor. Ayrıca canlı atmosferi, diğer yerlere feribotla kolay ulaşımı ve yerel işletmelerin tadını çıkarma fırsatını da vurguluyorlar."

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

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

Dil Bölge
İngilizce Amerika Birleşik Devletleri, Arjantin, Birleşik Krallık, Bolivya, Brezilya, Dominik Cumhuriyeti, Ekvador, Guatemala, Hindistan, Japonya, Kolombiya, Kosta Rika, Meksika, Paraguay, Peru, Şili, Uruguay, Venezuela
Japonca Japonya
Portekizce Brezilya
İspanyolca Amerika Birleşik Devletleri, Arjantin, Bolivya, Dominik Cumhuriyeti, Ekvador, Guatemala, Kolombiya, Kosta Rika, Meksika, Paraguay, Peru, Şili, Uruguay, Venezuela

Yorum özeti isteğinde bulunma

Yorum özeti istemek için isteğin alan maskesine reviewSummary değerini ekleyin:

  • Place Details (New): reviewSummary
  • Text Search (New) ve Nearby Search (New): places.reviewSummary

Yorum özetinin atıfları, yerin Google Haritalar'daki yorumlarına yönlendiren bir bağlantı içermelidir. Bu bağlantıyı almak için isteğin alan maskesine reviewSummary.reviewsUri değerini ekleyin.

Yanıt gövdesi üç alan içerir:

  • text: Yapay zeka tarafından oluşturulan yorum özeti.
  • flagContentUri: Google tarafından kaldırılması için uygunsuz içerikleri işaretlemek amacıyla 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 istenmektedir:

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

Text Search (New) isteği

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

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 gövdesi ş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 merkezi 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 özetler, Google'ın politika ve standartlarına uygun şekilde doğru ilişkilendirmeyle birlikte sunulmalıdır. Daha fazla bilgi için Places API politikaları'na bakın.