Places API için Gemini modeli özellikleri

Places API için Gemini model özellikleri (Yeni), LLM'ler tarafından sağlanan verilerle birlikte bir yerle ilişkili verileri (çalışma saatleri, yorumlar, fotoğraflar) döndürmenize olanak tanıyacak şekilde Places API'ye LLM desteği sunar. Bu üretken veriler, bir yerle ilişkilendirilmiş verileri iyileştirmek için LLM'lerden toplanmış ve özetlenmiş veriler içerir.

Örneğin, "elektrikli araç şarj istasyonları" için yapılan standart bir metin araması (yeni), elektrikli araç şarjı hizmeti sunan yerlerin listesini döndürür. Yalnızca en yakın elektrikli araç şarj cihazını veya aracınızla uyumlu en yakın cihazı arıyorsanız bu tür bir yanıt uygundur.

Ancak, özellikle araç şarj olurken bir saat veya daha uzun süre orada olacaksanız şarj istasyonunun çevresindeki bölgeyi de daha iyi anlamak isteyebilirsiniz. Aynı arama için Gemini model özellikleri kullanıldığında yanıt, şarj istasyonunun çevresindeki alanla ilgili bilgiler de dahil olmak üzere yanıttaki her yerin dinamik, üretken açıklamalarını içerebilir:

  • "2-4 dakikalık yürüme mesafesinde Chef Chu's, Gen Korean BBQ House, Amber India, Pacific Catch gibi çeşitli yeme-içme ve alışveriş seçenekleri ve Walmart, Whole Foods Market, Trader Joe's gibi çeşitli marketler bulunmaktadır."

  • "Khao Kang Thai Kitchen, Roger's Deli & Donuts ve La Costeña gibi çeşitli yeme-içme ve alışveriş seçenekleri 1-5 dakikalık yürüme mesafesindedir. Suşi için Joy Sushi iyi bir seçenektir. Dollar Tree'da indirimli fiyatlarla çeşitli ürünler bulabilirsiniz."

LLM'lerden gelen bu üretken içerik, yanıtı iyileştirir ve kullanıcıların bilinçli bir karar vermelerine yardımcı olacak ek bilgiler sağlar.

Places API'ye AI destekli yeni özellikler eklendi (Yeni)

Bu özellikler, bir Places API (Yeni) yanıtına aşağıdaki verileri ekler:

Üretken yer özetleri

Üretken yer özetleri, bir yer kimliğine özgüdür. Yer özetleri, birçok farklı veri türünü yer için tek bir özet halinde toplar.

Places API (Yeni), üretken yer özetleri için iki tür sağlar:

  • Genel bakış özetleri: Kullanıcıların bir yerin anlık görüntüsünü almasına yardımcı olabilecek, ortalama 100 karakter uzunluğunda bir yere genel bakış.

  • Açıklama özetleri: Bir yerin en önemli özelliklerini kapsayan ayrıntılı bir genel bakış sunan, ortalama 400 karakter uzunluğunda daha uzun özetleridir.

Yer özetleri şu anda Kültür, Eğlence ve Eğlence, Yiyecek ve İçecek, Alışveriş ve Spor kategorilerindeki Desteklenen türler bölümünde gösterilen yer türleri için kullanılabilir.

Üretken alan özetleri

Üretken alan özetleri, LLM tarafından bir yerin yakınındaki alan için oluşturulur. Bir yerin alan özeti, kullanıcının karar vermesi için gereken tüm bilgileri içerebilir. Böylece kullanıcı, alan ayrıntılarına inmek için başka istek göndermek zorunda kalmaz.

Yanıt, alanın açıklamasının yanı sıra açıklamada atıfta bulunulan yerlerin yer kimliklerinin ve farklı içerik türlerine göre sıralanmış yerlerin listesini de içerir. Örneğin, bir içerik türü bölgedeki etkinliklerle ilişkili yerlerin listesini, diğeri ise bölgedeki restoranların listesini içerir.

Alan özetleri şu anda Konaklama kategorisindeki Desteklenen türler bölümünde gösterilen yer türleri ve electric_vehicle_charging_station, geocode ve premise yer türleri için kullanılabilir.

Yer ve alan özetleri oluşturma

Hem üretken yer özetleri hem de üretken alan özetleri Google tarafından sık sık çevrimdışı olarak oluşturulur. Bu özetlerin çevrimdışı olarak oluşturulmasını sağlayarak, Gemini tarafından desteklenen içerikten yararlanırken aynı zamanda Places API (Yeni)'den beklediğiniz performansı elde edebilirsiniz.

Google, bu özetleri mevcut en son bilgilere göre güncel olduklarından emin olmak için sık sık yeniden oluşturur. Bu, API'yi çağırdığınızda hizmetinizde en güncel verileri göstereceğiniz anlamına gelir.

Bağlama dayalı arama sonuçları

Metin Arama (Yeni), bir dizeye dayalı olarak bir dizi yerle ilgili bilgi döndürür. Örneğin, "İstanbul'da pizza" veya "İstanbul yakınındaki ayakkabı mağazaları". Metin Arama (Yeni) yanıtı, metin dizesine eşleşen yerlerin ve istekte ayarlanan konum yanlılığının bir listesini içerir.

Yanıta bağlamsal arama sonuçları eklediğinizde yanıt, kullanıcıların aşağıdaki soruları yanıtlamasına yardımcı olan yorumlar, fotoğraflar ve gerekçeler içerir:

  • Sonuçlarda neden bu yeri görüyorum?
  • Neden burayı seçmeliyim?

Örneğin, bugün Yer Ayrıntıları (Yeni), Metin Arama (Yeni) veya Yakındaki Arama (Yeni) için yanıtta belirli bir yer içeren bir istekte bulundunuz. Döndürülen veriler söz konusu yerle ilişkili olduğundan, yer için yanıt verileri üç istek için de aynıdır.

Ancak yeni özellikleri kullanan bir metin arama (yeni) için yanıt, giriş sorgu dizesinin kendisinden türetilen verileri içerebilir. Yani bağlama dayalı arama sonuçları, sorgu dizesine özgüdür. Örneğin, aşağıdaki sorgu dizesini kullanarak bir Metin Arama (Yeni) isteği gönderirseniz:

"Mountain View, CA'da baharatlı vejetaryen restoran"

Ardından tüm giriş parametrelerini aynı bırakıp yalnızca sorgu dizesini şu şekilde değiştirin:

"Mountain View, CA'da baharatlı vegan restoran"

Her iki yanıtta da görünen bir restoran için yerle ilişkili olduğu için yerle ilgili yanıt verileri aynıdır. Ancak bağlama dayalı arama sonuçları, sorgu dizesinden türetildikleri için sorguya özgüdür. Ardından, yanıttaki hangi yerin arama istekleriyle en alakalı olduğuna karar vermelerine yardımcı olmak için kullanıcılarınıza bağlama dayalı arama sonuçlarından yorumları, fotoğrafları ve gerekçeleri gösterebilirsiniz.

Places API için Gemini model özelliklerini etkinleştirme (Yeni)

Places API'de (Yeni) Gemini model özelliklerini kullanmak için Places API'yi (Yeni) etkinleştirmeniz gerekir. Daha fazla bilgi için Google Cloud projenizi ayarlama başlıklı makaleyi inceleyin.

Deneysel sürümle ilgili kısıtlamalar

Bu sürüm, yalnızca ABD'deki yerlerin İngilizce dilindeki yer ve alan özetlerini destekler.

Gemini nedir?

Gemini modeli hakkında bilgi edinmek için Gemini ile ilgili SSS başlıklı makaleyi inceleyin.

Üretken yer özeti isteme

Yer özetleri, LLM tarafından belirli bir yer için oluşturulan üretken özetlerdir. Places API (Yeni), bir yanıta iki tür özet ekler:

  • Bir yerle ilişkili statik editoryal özete benzer, üretken Genel bakış özetleri. Ortalama 100 karakter uzunluğundaki üretken kısa özetlerin birkaç avantajı vardır:

    • Birçok yerde editoryal özet bulunmaz. Bu özetler, bir yerle ilgili bilgi eksikliğini giderir.

    • Bunlar LLM'den oluşturulur. Bu nedenle, mekan sahibinin bunları korumasına gerek yoktur.

  • Açıklama üretken özetleri, Google Haritalar'daki yorumlar da dahil olmak üzere birçok kaynaktan elde edilir. Ortalama 400 karakter uzunluğundaki bu açıklama, uzun açıklamayı oluşturmak için kullanılan yorumların listesini içerir.

    Açıklama özetlerini manuel olarak oluşturmak için bir kişinin birçok konumdan veri toplaması, ardından içeriği manuel olarak oluşturması ve sürdürmesi gerekir. Places API (Yeni) için Gemini model özellikleri, oluşturulan içeriğin kapsamını ve güncelliğini korumak amacıyla bu özetlerin LLM'lerden oluşturulmasını sağlar.

Yer özetleri Yer Ayrıntıları (Yeni), Metin Arama (Yeni) ve Yakındakiler Arama (Yeni) tarafından desteklenir. Yanıta yer özetini eklemek için isteğin alan maskesine aşağıdaki alanı ekleyin:

  • Yer Ayrıntıları: generativeSummary

  • Metin Arama ve Yakındaki Arama: places.generativeSummary

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

  • generativeSummary.overview: Üretken modele genel bakış özeti.
  • generativeSummary.description: Üretken açıklama özeti.
  • generativeSummary.references: Açıklama özetine içerik sağlamak için kullanılan en fazla beş yorumdan oluşan dizi. Açıklama özeti yoksa bu dizi boştur.
  • overviewFlagContentUri: Kullanıcıların genel bakış özetiyle ilgili bir sorunu işaretleyebileceği bağlantı.
  • descriptionFlagContentUri: Kullanıcıların açıklama özetiyle ilgili bir sorunu işaretleyebileceği bağlantı.

Örnek genel bakış ve açıklama özeti isteği

Bu örnekte, generativeSummary.overview, generativeSummary.description ve generativeSummary.references alanları dahil olmak üzere generativeSummary nesnesinin tamamını döndürmek için places.generativeSummary alan maskesi kullanılmaktadı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çimdedir:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        },
        "description": {
          "text": "Pakistani restaurant dishing up comfort food including vegetarian, vegan, and halal options.
          Offerings include chicken tikka masala, naan, and paratha. There's also a salad bar, and dessert is
          available.\nOpen for breakfast, lunch, and dinner, the venue has a casual atmosphere and outdoor rooftop
          seating. People mention the ambiance and say the service is prompt.\nCustomers typically spend $10–20.",
          "languageCode": "en-US"
        },
        "references": {
          "reviews": [
            {
              "name": "places/ChIJQ8nPjFW3j4ARcAaUg5pF-Ts/reviews/ChZDSUhNMG9nS0VJQ0FnSUN4aUtDbVJREAE",
              "relativePublishTimeDescription": "12 months ago",
              "rating": 5,
              "text": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Insanely good Pakistani food with the perfect ambiance! This food never disappoints AND THEY ARE OPEN TILL MIDNIGHT!!",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "John Smith",
                "uri": "https://www.google.com/maps/contrib/11685942231/reviews",
                "photoUri": "https://lh3.googleusercontent.com/a-/ALV-UjWbImVTop_1d-cc-rp-mo"
              },
              "publishTime": "2023-05-09T07:24:36Z"
              "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChRAB&d=17924085&t=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m7558ccfc943:0x3bf9459a83940670"
            },
            . . .
          ]
        },
        "overviewFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOGZiNzU1O085&t=12",
        "descriptionFlagContentUri": "https://www.google.com/local/review/rap/report?postId=CiUweDgwOG&t=12"
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Indian restaurant offering comfort food including vegetarian and vegan options.",
          "languageCode": "en-US"
        },
        . . .
}

Örnek genel bakış özeti isteği

Bu örnek metin araması, yalnızca Mountain View, CA'daki baharatlı vejetaryen restoranların 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.overview" \
https://places.googleapis.com/v1/places:searchText

Yanıtta, overview.text ve overview.languageCode içeren generativeSummary.overview alanı bulunur:

{
  "places": [
    {
      "id": "ChIJQ8nPjFW3j4ARcAaUg5pF-Ts",
      "displayName": {
        "text": "Zareen's",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual restaurant serving halal Pakistani and Indian cuisine, plus a selection of vegetarian items.",
          "languageCode": "en-US"
        }
      }
    },
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      },
      "generativeSummary": {
        "overview": {
          "text": "Casual eatery offering vegetarian & non-vegetarian Indian fare, plus breads & desserts.",
          "languageCode": "en-US"
        }
      }
    },
  . . .
}

Üretken alan özeti isteme

Alan özetleri, LLM tarafından bir yerin yakınındaki alan için oluşturulan üretken özetlerdir. Alan özetleri, bir yer hakkında karar veren kullanıcılar için önemli olabilir.

Örneğin, yeni bir şehirde otel rezervasyonu yapmak istediğinizde, gereksinimlerinizi karşılayan bir otel bulabilirken otelin çevresindeki bölge hakkında da daha fazla bilgi edinmek istersiniz. Çevredeki alanın haritasını inceleyip haritadaki her yeri incelemek yerine otel için bir alan özeti oluşturabilirsiniz.

Alan özetleri Yer Ayrıntıları (Yeni), Metin Arama (Yeni) ve Yakındakiler Arama (Yeni) tarafından desteklenir.

Alan özetini yanıta dahil etmek için isteğin alan maskesini ekleyin:

  • areaSummary (Yer Ayrıntıları)
  • places.areaSummary (Metin Arama ve Yakında Arama).

Yanıtta bir yer için areaSummary alanına, Google'ın kaldırabilmesi için uygunsuz içerikleri işaretlemek üzere kullanabileceğiniz flagContentUri alanı eklenir. Ayrıca dört adede kadar contentBlocks dizisi içerir. Her blokun konusu yerin türüne bağlıdır:

  • electric_vehicle_charging_station türündeki bir yer olarak tanımlanan elektrikli araç şarj istasyonu için konu blokları şunlardır: "overview", "coffee", "restaurant" ve "store".

  • Konaklama kategorisi ve belirli geocode ile premise yer türleri tarafından tanımlanmış bir türe sahip bir yer için konu blokları şunları içerir: "overview", "activity", "restaurant" ve "store".

Elektrikli araç şarj istasyonunun alan özeti için örnek istek

Bu örnek Yer Ayrıntısı isteği, Mountain View'daki belirli bir elektrikli araç şarj istasyonunun ChIJC5b6QKiwj4ARgn2EwlnJnWU yer kimliğiyle tanımlanan alan özetini döndürüyor:

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

Yanıtta, contentBlocks dizisi dahil olmak üzere areaSummary alanı bulunur:

  • topic alanı, içerik bloğunun türünü belirtir. Bu örnekteki yer bir elektrikli araç şarj istasyonu olduğundan dört içerik bloğu "overview", "coffee", "restaurant" ve "store"'tır.

  • content alanı, dil kodu da dahil olmak üzere ilgili konunun özetini içerir.

  • references dizisi, içerik bloğuna içerik sağlamak için kullanılan yer kaynağı adlarını places/PLACE_ID biçiminde belirtir.

{
  "id": "ChIJC5b6QKiwj4ARgn2EwlnJnWU",
  "displayName": {
    "text": "EVgo Charging Station",
    "languageCode": "en"
  },
  "areaSummary": {
    "contentBlocks": [
      {
        "topic": "overview",
        "content": {
          "text": "Within a 4-minute walk, there are several dining and shopping options from this charging station, including Starbucks and Los Altos Taqueria.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY",
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ"
          ]
        }
      },
      {
        "topic": "coffee",
        "content": {
          "text": "Starbucks offers Wi-Fi, light bites, and its signature roasts in a cozy space.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJ-f-lEaiwj4ARB1IwfdLFfRY"
          ]
        }
      },
      {
        "topic": "restaurant",
        "content": {
          "text": "Los Altos Taqueria serves classic Mexican dishes in a kid-friendly venue.\nHyderabad Dum Biryani specializes in vegetarian and vegan Indian fare, including lunch and dinner options.\nSushi Jin is a popular spot for sushi and other Japanese dishes, featuring a relaxed atmosphere.\nSuper tacos el conrro is a kid-friendly spot for Mexican fare.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJhzHBsAe6j4ARvq9oi8u-bqQ",
            "places/ChIJETHw0F-7j4AR85V_I6OobCI",
            "places/ChIJ-9pg_Qmxj4AR4deSLfZINW0",
            "places/ChIJvcqEhTyxj4AR4ZdQevNxGZk"
          ]
        }
      },
      {
        "topic": "store",
        "content": {
          "text": "Safeway provides a range of groceries, along with a deli and a bakery.",
          "languageCode": "en-US"
        },
        "references": {
          "places": [
            "places/ChIJF7_iDaiwj4ARzdC4NlGzJFI"
          ]
        }
      }
    ],
    "flagContentUri": "https://www.google.com/local/review/rap/report?postId=IhkpuV1UwBQ&d=17924085&t=12"
  }
}

Bir otelin alan özeti için örnek istek

Bu örnek metin arama isteği, Kaliforniya, Mountain View'daki otelleri ister:

curl -X  POST -d '{
  "textQuery": "Hotels",
  "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.areaSummary" \
https://places.googleapis.com/v1/places:searchText

Yanıt, contentBlocks dizisi dahil olmak üzere areaSummary alanını içerir. Otel türündeki yerler için verilen yanıtta "overview", "activity", "restaurant" ve "store" konularına yönelik içerik blokları bulunur:

{
  "places": [
    {
      "id": "ChIJ81X7bC63j4ARNJTuqMFBq-4",
      "displayName": {
        "text": "Shashi Hotel Mountain View, an Urban Resort",
        "languageCode": "en"
      },
      "areaSummary": {
        "contentBlocks": [
          {
            "topic": "overview",
            "content": {
              "text": "This area offers several attractions, including Cinemark Century Mountain View 16 and Computer History Museum. Charleston Park provides picnic spots and the Pear Theatre hosts performances.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJo4za6vi5j4ARMua093RgGGA",
                "places/ChIJ4V-yslC3j4ARE6I2cpvyOeU"
              ]
            }
          },
          {
            "topic": "activity",
            "content": {
              "text": "Cinemark Century Mountain View 16 offers XD and RealD 3D screens, plus comfortable seating and a snack bar.\nComputer History Museum showcases the evolution of technology with interactive exhibits.\nRyptic Room Escape Mountain View presents themed rooms where teams solve puzzles to escape.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJOYvCo1W3j4AR1LAifgk13rs",
                "places/ChIJm7NJkla3j4AR8vR-HWRxgOo",
                "places/ChIJ1_ZkCKqwj4ARPaLA4yiEtdI"
              ]
            }
          },
          {
            "topic": "restaurant",
            "content": {
              "text": "Cucina Venti Restaurant prepares Italian cuisine in a rustic setting with outdoor seating.\nRoger Bar and Restaurant provides cocktails on tap, along with an indoor-outdoor bar and dining area.\nBroma Restaurant serves Spanish-inspired tapas and shareable plates in a trendy atmosphere.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJC_3cdla3j4ARMgf4Pw8Irek",
                "places/ChIJh1Y1MA23j4AREJz6Kxl75Uo",
                "places/ChIJLRvDZtu3j4ARgoNrKZnNw8g"
              ]
            }
          },
          {
            "topic": "store",
            "content": {
              "text": "NASA Gear Store and Food Mart offer a variety of gifts and convenience store items.",
              "languageCode": "en-US"
            },
            "references": {
              "places": [
                "places/ChIJh64-r0O3j4ARy1P41IH2j3k",
                "places/ChIJ5ZJtB8u3j4ARR0gohzD8-ns"
              ]
            }
          }
        ],
        "flagContentUri": "https://www.google.com/local/review/rap/report?postId=GQAAAA085&t=12"
      }
    },
    ...
  ]
}

Bağlama dayalı arama sonuçlarını isteme

Metin Arama (Yeni) isteğinin yanıtı, giriş arama dizesinin ölçütleriyle eşleşen bir yer dizisi içerir. Artık API'ye yapılan giriş sorgusuna göre yanıtta bağlamsal arama verileri isteyebilirsiniz.

Bağlamsal özetleri desteklemek için Metin Arama (Yeni) yanıtı, yanıttaki places dizisiyle aynı düzeyde olan contextualContents adlı yeni bir dizi içerir:

{
  "places": [],
  "contextualContents":[]
}

contextualContents dizisindeki ContextualContent türündeki her öğe, places dizisindeki yerle aynı dizi konumundadır. Yani contextualContents[0] öğesi places[0] konumundaki yere karşılık gelir.

Her dizi öğesi aşağıdaki dizi alanlarını içerir:

  • contextualContents.reviews: En fazla üç yorumdan oluşan bir dizi.
  • contextualContents.photos: En fazla beş fotoğraf içeren bir dizi.
  • contextualContents.justifications: Aşağıdakiler dahil olmak üzere yer için açıklamalar dizisi:

    • reviewJustification: Kullanıcı yorumunun son kullanıcının ilgisini çekebilecek bir bölümünü öne çıkarın.
    • businessAvailabilityAttributesJustification: Bir işletmenin son kullanıcının ilgisini çekebilecek özelliklerini içerir.

Bağlamsal arama sonuçlarını yanıta dahil etmek için Metin Arama (Yeni) isteğinin alan maskesine contextualContents ekleyin:

curl -X  POST  -d '{
  "textQuery": "Spicy vegetarian restaurant in Mountain View, CA",
  "openNow": true,
  "maxResultCount": 3
}' \
-H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: places.id,places.displayName,contextualContents" \
https://places.googleapis.com/v1/places:searchText

Yanıt, yanıttaki her yer için contextualContents dizisini içerir:

{
  "places": [
    {
      "id": "ChIJETHw0F-7j4AR85V_I6OobCI",
      "displayName": {
        "text": "Hyderabad Dum Biryani",
        "languageCode": "en"
      }
    },
    . . .
  ],
  "contextualContents": [
    {
      "reviews": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhNMG9nS0VJQ0FnSURSeEtMdHZ3RRAB",
          "relativePublishTimeDescription": "a year ago",
          "rating": 5,
          "text": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset to
            the tofu 65) and veg pakoras (very crunchy and awesome flavor). We
            enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "Very tasty! Rich spices and textures. We really appreciated
            all of the vegan options. We shared samosas (great sauce!) , tofu 65
            (spicy!!), gobi manchurian (less flavorful but a nice sweet offset
            to the tofu 65) and veg pakoras (very crunchy and awesome flavor).
            We enjoyed all of it, with the pakoras being the table's favorite.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Jane Doe",
            "uri": "https://www.google.com/maps/contrib/113193/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a-/ALVVXe4iwrp-mo-br100"
          },
          "publishTime": "2023-04-18T02:48:02Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF24085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!1sChZDSUhb1e9679abc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChdDSUhzlhTG53RRAB",
          "relativePublishTimeDescription": "10 months ago",
          "rating": 5,
          "text": {
            "text": "This is a nice little spot to eat at. I'm a big fan of
            curries, and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "originalText": {
            "text": "This is a nice little spot to eat at. I'm a big fan of curries,
            and they are spot on when it comes to flavor and spice. I highly recommend this place.",
            "languageCode": "en"
          },
          "authorAttribution": {
            "displayName": "Bob Jones",
            "uri": "https://www.google.com/maps/contrib/11034435/reviews",
            "photoUri": "https://lh3.googleusercontent.com/a/ACg8ocIAGguhz-EccsS9p-mo-ba4-br100"
          },
          "publishTime": "2023-07-03T16:51:49Z",
          "flagContentUri": "https://www.google.com/local/review/rap/report?postIWkF3EAE&d=17924085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhb1e9679abc80b8db"
        },
        . . .
      ],
      "photos": [
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/Vt2DAKajwJfgC_I-baPKjSeSw-JAXY-tCZOBAe7pBxxIS0Vo1w23sCO9o5RzoxJ",
          "widthPx": 1920,
          "heightPx": 1080,
          "authorAttributions": [
            {
              "displayName": "A Google User",
              "uri": "//maps.google.com/maps/contrib/113010465422",
              "photoUri": "//lh3.googleusercontent.com/a-/ALV-UjV_8hbrtgyc0-p-k-no-mo"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId=ChZDSWkF3EAE&d=15&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!1sChZDSUhNbc80b8db"
        },
        {
          "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/photos/AUGGfZkJ4MMlLikE2EyP-b13GeFZ9Nwhk24vK212hZo",
          "widthPx": 960,
          "heightPx": 720,
          "authorAttributions": [
            {
              "displayName": "Toast"
            }
          ],
          "flagContentUri": "https://www.google.com/local/review/rap/report?postId4085&t=1",
          "googleMapsUri": "https://www.google.com/maps/reviews/data=!4m6!14m5!1m4!2m3!b1e9679abc80b8db"
        },
        . . .
      ],
      "justifications": [
        {
          "reviewJustification": {
            "highlightedText": {
              "text": "\"Not too spicy or oily.\"",
              "highlightedTextRanges": [
                {
                  "startIndex": 9,
                  "endIndex": 14
                }
              ]
            },
            "review": {
              "name": "places/ChIJETHw0F-7j4AR85V_I6OobCI/reviews/ChZDSUhNMG9nS0VJQ0FnSUR4djR2Z1B3EAE",
              "relativePublishTimeDescription": "10 months ago",
              "rating": 5,
              "text": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "originalText": {
                "text": "Not too spicy or oily. We have the mutton dum biryanis
                and tandoori fish. Very flavorful. The food was served promptly.
                Clean environment. A little small more like a hole in the wall.
                We'd come back for sure.",
                "languageCode": "en"
              },
              "authorAttribution": {
                "displayName": "Stan Davis",
                "uri": "https://www.google.com/maps/contrib/112959/reviews",
                "photoUri": "https://lh3.googleuser-cc-rp-mo"
              },
              "publishTime": "2023-06-18T06:12:41Z",
              "flagContentUri": "https://www.google.com/local/review/rap/report?postt=1",
              "googleMapsUri": "https://www.google.com/maps/reviews/75a95dd8ebd:0xb1e9679abc80b8db"
            }
          }
        },
        {
          "businessAvailabilityAttributesJustification": {
            "dineIn": true
          }
        }
      ]
    },
    . . .
  ]
}

Otomotiv kullanım alanları için uygulama kılavuzu

Google, sürücü güvenliği için otomotiv deneyimlerinde üretken yapay zeka özetlerini park modunda oluşturmayı önerir. Sürüş modunda özetler oluşturuluyorsa sürücünün dikkatinin yola hızlıca dönmesini sağlamak için ekrandaki bilgiler basit, net ve kısa olmalıdır.

  • En fazla 3 satır
  • En fazla 120 karakter veya 24 kelime
  • Minimum ön boyut 24 dp'dir.

Özellikle otomotiv bağlamında, üretken yapay zeka özetlerini güvenli ve tüm yerel yasalara ve yönetmeliklere uygun şekilde oluşturmak geliştiricinin sorumluluğundadır.

İlişkilendirmeler

Uygulamanızda yorumlar, fotoğraflar ve üretken yapay zeka özetlerini (hem yer hem de alan özetleri dahil) gösterirken gerekli ilişkilendirmeleri de gösterdiğinizden emin olmanız gerekir.

Üretken özetler için ilişkilendirmeleri gösterme

Uygulamanızda yer ve bölge özetleri dahil üretken yapay zeka özetleri gösterdiğinizde gerekli atıfları da göstermeniz gerekir. Bu bölümde, uygulamanızda üretken yapay zeka özetlerini nasıl gösterdiğinize bağlı olarak ilişkilendirmelerin nasıl gösterileceği açıklanmaktadır.

İlişkilendirmede her durumda normal cümle düzeni kullanılmalıdır. İlişkilendirme ve Google logosu tüm renk, stil ve yazı tipi standartlarına uygun olmalıdır. Bu standartlar hakkında daha fazla bilgi için Places API (Yeni) Politikaları başlıklı makaleyi inceleyin.

Diğer Google verileri bağlamında gösterilen üretken yapay zeka özeti

Bu durumda, Google'ın içeriği başka bir yerde ilişkilendirmesine bağlı olarak üretken yapay zeka ilişkilendirmesi, özetin üzerinde veya altında tek başına gösterilebilir.

Atıf için bu resimde gösterildiği gibi "Yapay zeka tarafından özetlendi" metnini kullanın:

İlişkilendirme için "Yapay zeka tarafından özetlendi" metnini kullanın.

Üretken yapay zeka özeti tek başına gösteriliyor

Üretken yapay zeka özeti, Google Haritalar'daki diğer içeriklerden ayrı olarak göründüğünde hem üretken yapay zeka ilişkilendirmesini hem de Google ilişkilendirmesini noktalı virgül ile ayırarak içermelidir. Atıf için "Yapay zeka tarafından özetlendi" metnini ve bu resimde gösterilen Google logosunu kullanın:

Ayrı olarak gösterilen özet için üretken yapay zeka ilişkilendirmesini ve Google ilişkilendirmesini noktalı virgül ile ayırarak ekleyin.

Bir listede tekrarlanan üretken yapay zeka özeti

Üretken yapay zekayı tekrarlarken, özete genel bakışı bir yer listesine yerleştirirken:

  • Liste içeriği Google ile ilişkilendirilir
  • Gösterilen özetler yapay zeka tarafından oluşturulur.
  • İçerik Google'da mevcuttur

İlişkilendirme, listenin üstünde veya altında tek bir satırda gösterilmelidir. Yapay zeka ilişkilendirmesi solda, Google ilişkilendirmesi ise sağda hizalanır:

Liste için, ilişkilendirmeyi tek bir satırda listenin üstünde veya altında görüntüleyin.

Bir listede daha uzun biçimli üretken yapay zeka açıklama özetleri kullanılıyorsa her özetin yapay zeka ilişkilendirmesi ("Yapay zeka tarafından özetlendi" bilgi simgesi/düğmesi) olmalıdır.

Üretken yapay zeka özetiyle ilgili bilgileri iletişim kutusunda görüntüleme

Üretken yapay zeka özetiyle birlikte, son kullanıcıların özet hakkında bilgi görüntüleyebileceği bir iletişim kutusu ve flagContentUri alanındaki özetin benzersiz tanımlayıcısını kullanarak sorunları bildirmek için bir bağlantı sağlamanız gerekir. Üretken yapay zeka açıklama özeti kullanırken özetin kaynakları hakkında bilgi (referanslar) eklemeniz gerekir.

Yukarıdaki örneklerde gösterildiği gibi, yapay zeka ilişkilendirmesi ile birlikte bir bilgi simgesi (etkileşim olanağı olarak) ekleyip yapay zeka ilişkilendirme alanı ile simgesinin bir basmaya/tıklamaya yanıt vermesini sağlayarak bu iletişim kutusuna erişimi etkinleştirin.

Üretken yer özetleri için şunları gösterin:

Hakkında Yapay zeka tarafından oluşturulan yer özetleri, Google yorumlarından ve diğer verilerden elde edilir.
Sorun Bildir Özetin içeriğiyle ilgili bir sorunu Google'a bildirmek için flagContentUri alanındaki bağlantıyı kullanın.
Referanslar Kaynak yorumları

Örneğin:

Üretken yapay zeka özetiyle ilgili bilgileri bir iletişim kutusunda göster.

Üretken alan özetleri için şunları gösterin:

Hakkında Yapay zeka tarafından oluşturulan alan özetleri, Google yorumlarından ve yerel verilerden elde edilir.
Sorun Bildir Özetin içeriğiyle ilgili bir sorunu Google'a bildirmek için flagContentUri alanındaki bağlantıyı kullanın.

Alan özeti ilişkilendirmesini görüntüleyin.