Yapay zeka destekli yer özetleri

Yapay zeka destekli yer özetleri, belirli bir yer kimliğine özel 100 karakterlik kısa özetlerdir. Yer özetleri, kullanıcıların bir yerin anlık görüntüsünü almasına yardımcı olmak için birçok farklı veri türünü üst düzey bir genel bakışta toplar.

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

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

Yer özetleri; Yer Ayrıntıları (Yeni), Metinle Arama (Yeni) ve Yakında Arama (Yeni) tarafından desteklenir. Yer özetleri, Desteklenen türler bölümünde gösterilen yer türleri için Kültür, Eğlence ve Rekreasyon, Yeme İçme, Alışveriş,Hizmetler ve Spor kategorilerinde kullanılabilir.

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

Dil Bölge
İngilizce

Hindistan

Amerika Birleşik Devletleri

Üretken yer özeti isteğinde bulunma

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

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

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

  • generativeSummary: Yer özeti.
  • overviewFlagContentUri: Kullanıcıların yer özetiyle ilgili bir sorunu işaretleyebileceği bağlantı.
  • disclosureText: Atıflara eklenmesi 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, IL'deki bir suşi restoranı için overviewözet döndürüyor:

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çimde olmalıdır:

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

Metin Arama (Yeni) isteği

Aşağıdaki Metin Arama (Yeni) isteği, Mountain View, CA'daki overviewbaharatlı vejetaryen restoranlarla ilgili bir özet döndürüyor:

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çimde olmalıdır:

{
  "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ınlarda Arama (Yeni) isteği, Portland, Oregon'daki restoran ve kafeler için overviewözet döndürüyor:

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çimde olmalıdır:

{
  "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 özetlere, Google'ın politikaları ve standartlarına uygun şekilde gerekli atıf yapılmalıdır. Daha fazla bilgi için Places API Politikaları'na bakın.