Yapay zeka destekli yer özetleri

Yapay zeka destekli yer özetleri, belirli bir yer kimliğine özgü 100 karakterlik kısa genel bakışlardır. Yer özetleri, kullanıcıların bir yer hakkında genel bilgi edinmesine yardımcı olmak için birçok farklı veri türünü üst düzey bir genel bakışta birleştirir.

Örneğin, yer özetlerinde bir konumda satın alınabilecek popüler yiyecekler, hizmetler veya ürünler öne çıkarılabilir:

  • "Forum Shops'ta yer alan, rahat bir ortamda geleneksel İtalyan yemeklerinin büyük porsiyonlar halinde servis edildiği restoran."
  • "Saç kesimi, boyama ve fön hizmetleri sunan şık salon."
  • "Çeşitli vintage dekor, mobilya ve kıyafetler sunan birçok satıcının bulunduğu büyük mağaza."

Yer özetleri, Yer Ayrıntıları (Yeni), Text Search (New) ve Yakında Arama (Yeni) tarafından desteklenir. Yer özetleri, Kültür, Eğlence ve Dinlenme, Yiyecek ve İçecek, Alışveriş, Hizmetler ve Spor kategorileri için Desteklenen türler bölümünde gösterilen yer türlerinde kullanılabilir.

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

Dil Bölge
İngilizce

Avustralya

Kanada

Hindistan

Yeni Zelanda

Singapur

Amerika Birleşik Devletleri

Üretken yer özeti isteme

Yanıtta yer özeti döndürmek için isteğin alan maskesine aşağıdaki alanı ekleyin:

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

generativeSummary alanı aşağıdaki alanları içerir:

  • generativeSummary: Yer özeti.
  • overviewFlagContentUri: Kullanıcıların yer özetiyle ilgili bir sorunu bildirebileceği bağlantı.
  • 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 Yer Ayrıntıları (Yeni) isteği, Chicago, Illinois'deki bir suşi restoranı için overview özetini döndürür:

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"

Yanıt şu biçimdedir:

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

Text Search (New) isteği

Aşağıdaki Text Search (Yeni) isteği, Mountain View, Kaliforniya'daki acılı vejetaryen restoranlar için overview özetini döndürür:

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'

Yanıt şu biçimdedir:

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

Yakında Arama (Yeni) isteği

Aşağıdaki Yakında Arama (Yeni) isteği, Portland, Oregon'daki restoran ve kafeler için overview özetini döndürür:

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'

Yanıt şu biçimdedir:

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

İ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ı'nı inceleyin.