Yapay zeka destekli yer özetleri

Yapay zeka destekli yer özetleri, belirli bir yer kimliğine özgü 100 karakterlik kısa özetlerdir. Yer özetleri, kullanıcılara bir yerin anlık görüntüsünü sunmak 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 ürünleri, mobilyalar ve kıyafetler sunan birçok satıcının bulunduğu büyük mağaza."

Yer özetleri; Yer Ayrıntıları (Yeni), Metin Arama (Yeni) ve Yakındaki 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, Yiyecek ve İçecek, Alışveriş,Hizmetler ve Spor kategorilerinde kullanılabilir.

Üretken yer özeti isteme

Yanıtla 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ınlarda 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: Açıklama metniyle yerelleştirilmiş bir metin dizesi. Bu dize, "Gemini ile özetlendi" açıklama metnini içermeli ve atıflara eklenmelidir.

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

Metin Arama (Yeni) isteği

Aşağıdaki Metin Arama (Yeni) isteği, Mountain View, CA'daki overview baharatlı vejetaryen restoranları için 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ç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ındaki 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ç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 özetlere, Google'ın politikaları ve standartları uyarınca uygun atıf eklenmelidir. Daha fazla bilgi için Places API Politikaları'nı inceleyin.