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), 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.

Önemli yerler için yer özetleri aşağıdaki dillerde ve bölgelerde 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 bildirebileceğ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, 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ç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 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ç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 ö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ç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.