Yapay zeka destekli yer özetleri

Yapay zeka destekli yer özetleri, belirli bir yer kimliğine özgü kısa, 100 karakterlik genel bakışlardır. 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ış altında toplar.

Örneğin, yer özetleri bir konumda satın alınabilecek popüler yiyecekleri, hizmetleri veya ürünleri öne çıkarabilir:

  • "Forum Shops'da, geleneksel İtalyan yemeklerinin büyük porsiyonlarını rahat bir ortamda sunan restoran."
  • "Saç kesimi, boyama ve fön hizmeti veren şı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ındakiler Arama (Yeni) tarafından desteklenir. Yer özetleri, Kültür, Eğlence ve Aktiviteler, Yiyecek ve İçecek, Alışveriş,Hizmetler ve Spor kategorilerinde Desteklenen türler bölümünde gösterilen yer türleri için kullanılabilir.

Üretken yer özeti isteme

Yanıtta bir 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ındakiler Arama (Yeni): places.generativeSummary

generativeSummary alanında aşağıdaki alanlar bulunur:

  • generativeSummary: Yer özeti.
  • overviewFlagContentUri: Kullanıcıların yer özetiyle ilgili bir sorunu işaretleyebileceği bağlantı.
  • disclosureText: "Gemini ile özetlendi" açıklama metnini içeren ve ilişkilendirmelere dahil edilmesi gereken yerelleştirilmiş bir metin dizesi.

Yer Ayrıntıları (Yeni) isteği

Aşağıdaki Yer Ayrıntıları (Yeni) isteği, Illinois, Chicago'daki 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 şekildedir:

{
  "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, Kaliforniya, Mountain View'daki baharatlı vejetaryen restoranlar için bir overview özeti 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 şekildedir:

{
  "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, Oregon, Portland'daki restoran ve kafeler için overview özet 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 şekildedir:

{
  "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 özetlerde, Google'ın politikaları ve standartlarına uygun şekilde uygun ilişkilendirme bulunmalıdır. Daha fazla bilgi için Places API ile ilgili politikalar başlıklı makaleyi inceleyin.