Yapay zeka destekli alan özetleri

Yapay zeka destekli alan özetleri, bir yerin çevresindeki alan için oluşturulur. Bölge özetleri, kullanıcıların nereye gidecekleri ve gittiklerinde ne yapacakları konusunda daha bilinçli bir karar verebilmeleri için yakındaki ilgi çekici yerler de dahil olmak üzere bir konumla ilgili ek bağlam bilgisi sağlar.

Örneğin, yeni bir şehri ziyaret ederken otel için oluşturulan mahalle özetini görüntüleyerek çevredeki alan hakkında daha fazla bilgi edinebilirsiniz:

  • "North Beach ve Chinatown'ı bir araya getiren San Francisco'daki bu hareketli bölge, Finans Bölgesi'nin kuzeybatısında yer alır ve edebiyatla ilgili önemli yerler, benzersiz kültürel cazibe merkezleri ve çeşitli restoranlar içerir. Önemli yerler arasında ikonik City Lights Bookstore, büyüleyici Cable Car Museum ve hareketli Chinatown sokakları yer alır.

    Bölge, tarih ve kültürün benzersiz bir karışımını sunuyor. Yaya dostu bir ortam, bazı tepeler ve kalabalıklar olmasına rağmen keşfe davet ediyor. City Lights Bookstore'da edebiyat tarihine yolculuk yapın, tapınakları ve fal kurabiyesi fabrikalarıyla Çin Mahallesi'nin canlı kültürünü deneyimleyin veya Cable Car Museum'da zamanda geriye gidin. Otantik Çin mutfağından lezzetli pizzaya kadar çeşitli yemek seçenekleri sizi bekliyor."

Elektrikli araç şarj etmeyi düşünüyorsanız yakındaki kafeleri veya beklerken ziyaret edebileceğiniz restoranları bulmak için elektrikli araç şarj istasyonuyla ilgili oluşturulan özeti görüntüleyebilirsiniz:

  • "Bu bölgede Starbucks, Sushi Jin ve Safeway gibi 9 dakikalık yürüme mesafesinde çeşitli yemek seçenekleri sunulmaktadır."

Yanıtta, alanın açıklamasının yanı sıra açıklamada referans verilen yerlerin yer kimliklerinin listesi de yer alır.

Places API (Yeni), iki tür yapay zeka destekli alan özeti sunar:

  • premise, street_address türündeki yerler ve Konut ile Konaklama kategorilerindeki tüm türler için yakındaki ilgi çekici yerlere dair üst düzey genel bakışlar sunan mahalle özetleri.
  • Elektrikli araç şarj istasyonu (EVCS) olanak özetleri: electric_vehicle_charging_station türündeki yerler için yakındaki ilgi çekici yerlere dair üst düzey genel bakış bilgileri sağlar.

Yapay zeka destekli alan özetleri şu özelliklerde desteklenir: Yer Ayrıntıları (Yeni), Metin Arama (Yeni), ve Yakınlardaki Arama (Yeni).

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

Dil Bölge
İngilizce Amerika Birleşik Devletleri

Mahalle özeti isteği

premise, street_address ve Konut ile Konaklama kategorilerindeki tüm türlere sahip yerler için mahalle özetleri oluşturulabilir. Yanıt olarak bir mahalle özeti döndürmek için isteğinizin alan maskesine aşağıdakileri ekleyin:

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

Yanıttaki bir yer için neighborhoodSummary alanı şunları içerir:

  • İki alt alan: overview ve description. overview alt alanı, yerle ilgili yakındaki önemli yerleri içerirken description alt alanı, çevreyle ilgili daha genel bilgiler sağlar. Her alt alan, place/PLACE_ID biçiminde referans verilen yer kaynağı adlarının bir listesini içerir.
  • Kullanıcıların oluşturulan özetle ilgili sorunları işaretleyebileceği bir flagContentUri bağlantı.
  • Atıflara eklenmesi gereken, "Gemini ile özetlendi" açıklama metnini içeren yerelleştirilmiş bir metin dizesi.

Aşağıdaki örnekte, New York City'deki bir otel için mahalle özeti isteniyor:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,neighborhoodSummary" \
'https://places.googleapis.com/v1/places/ChIJT0DdRo1ZwokRkufwSD-TdGM'

Yanıt şu biçimde olmalıdır:

{
  "id": "ChIJT0DdRo1ZwokRkufwSD-TdGM",
  "displayName": {
    "text": "Courtyard New York Manhattan/SoHo",
    "languageCode": "en"
  }
  "neighborhoodSummary": {
    "overview": {
      "content": {
        "text": "This area resides within SoHo, a trendy Lower Manhattan neighborhood celebrated for its upscale boutiques, designer shops, and thriving art scene. The area is home to the Color Factory and Dominique Ansel Bakery, known for its popular Cronuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "description": {
      "content": {
        "text": "SoHo's walkability and convenient public transportation options make exploration easy. A diverse array of restaurants and cafes cater to varied tastes. SoHo's central location, surrounded by vibrant neighborhoods, contributes to its fast-paced and energetic atmosphere, with a focus on fashion and design.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZd0F3oxZwokRiaEouMZKQ-0",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=&d=17924085&t=12",
    "disclosureText": {
      "text": "Summarized with Gemini",
      "languageCode": "en-US"
    }
  }
}

EVCS hizmeti özeti isteğinde bulunma

Elektrikli araç şarj istasyonu (EVCS) olanak özetleri, electric_vehicle_charging_station türündeki yerler için oluşturulabilir. Yanıtın EVCS hizmeti özetini içermesi için isteğinizin alan maskesine aşağıdakileri ekleyin:

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

Yanıttaki bir yerin evChargeAmenitySummary alanı şunları içerir:

  • Dört alt alan: overview, coffee, restaurant ve store. Her alt alan, yakındaki önemli yerlerin kısa bir açıklamasını ve place/PLACE_ID biçiminde referans verilen yer kaynak adlarının bir listesini içerir.
  • Kullanıcıların oluşturulan özetle ilgili bir sorunu işaretleyebileceği flagContentUri bağlantısı.
  • Açıklama metni "Gemini ile özetlendi" olan ve atıflara eklenmesi gereken yerelleştirilmiş bir metin dizesi.

Aşağıdaki örnekte, Mountain View'deki bir şarj istasyonu için elektrikli araç şarj istasyonu olanağı özeti isteniyor:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,evChargeAmenitySummary" \
'https://places.googleapis.com/v1/places/ChIJtwHgNNa2j4ARlC8vbI9lLZA'

Yanıt şu biçimde olmalıdır:

{
  "id": "ChIJf8j-4z23j4AR_MQ2-bgMmrY",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "evChargeAmenitySummary": {
    "overview": {
      "content": {
        "text": "Within a short walk, there are several coffee and restaurant options, including Clocktower Coffee Roasting Company, Khao Kang Thai Kitchen, and Roger's Deli & Donuts.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q",
        /.../
      ]
    },
    "coffee": {
      "content": {
        "text": "Clocktower Coffee Roasting Company has Wi-Fi and a variety of coffee and pastries in a laid-back atmosphere.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJZZR2-j23j4ARi5CXEIAc57Q"
      ]
    },
    "restaurant": {
      "content": {
        "text": "Roger's Deli & Donuts is a bustling deli with sandwiches and breakfast items.\nJoy Sushi serves classic Japanese dishes, including vegetarian and healthy options.\nSubway is a chain sandwich shop offering its usual subs, wraps, and salads.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJQ4F3PBa3j4ARf7_QjN1Cklo",
        /.../
      ]
    },
    "store": {
      "content": {
        "text": "Rotten Robbie is a chain gas station with a convenience store and a restroom.",
        "languageCode": "en-US"
      },
      "referencedPlaces": [
        "places/ChIJA6deFBa3j4AREY0EyTEGhN8",
        /.../
      ]
    },
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ABCDEFG=1234567&t=12",
    "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.