Gemini-Modellfunktionen für die Places API

Mit den Gemini-Modellfunktionen für die Places API (neu) wird die Places API um die Unterstützung von LLMs erweitert. So können Sie die mit einem Ort verknüpften Daten (Öffnungszeiten, Rezensionen, Fotos) zusammen mit von LLMs bereitgestellten Daten zurückgeben. Diese generativen Daten enthalten aggregierte und zusammengefasste Daten aus den LLMs, um die Daten zu ergänzen, die bereits mit einem Ort verknüpft sind.

Eine standardmäßige Text Search (New) für „Ladestationen für Elektrofahrzeuge“ gibt beispielsweise eine Liste mit Orten zurück, an denen Ladestationen für Elektrofahrzeuge verfügbar sind. Diese Art von Antwort ist in Ordnung, wenn Sie nur nach der nächstgelegenen Ladestation für Elektrofahrzeuge oder der nächstgelegenen Ladestation suchen, die mit Ihrem Fahrzeug kompatibel ist.

Sie sollten sich aber auch ein besseres Bild von der Umgebung der Ladestation machen, insbesondere wenn Sie eine Stunde oder länger dort bleiben, während Ihr Fahrzeug geladen wird. Wenn Sie die Funktionen des Gemini-Modells für dieselbe Suche verwenden, kann die Antwort dynamische, generative Beschreibungen der einzelnen Orte in der Antwort enthalten, einschließlich Informationen zum Gebiet um die Ladestation herum:

  • „Im Umkreis von 2 bis 4 Gehminuten befinden sich mehrere Restaurants und Einkaufsmöglichkeiten, darunter Chef Chu's, Gen Korean BBQ House, Amber India, Pacific Catch und mehrere Lebensmittelgeschäfte wie Walmart, Whole Foods Market und Trader Joe's.“

  • „Im Umkreis von 1 bis 5 Gehminuten befinden sich mehrere Restaurants und Einkaufsmöglichkeiten, darunter Khao Kang Thai Kitchen, Roger's Deli & Donuts und La Costeña. Für Sushi ist Joy Sushi eine gute Option. Dollar Tree bietet eine Vielzahl von Lebensmitteln zu Discountpreisen an.“

Diese generativen Inhalte der LLMs verbessern die Antwort und liefern zusätzliche Informationen, die Nutzern helfen, fundierte Entscheidungen zu treffen.

Neue KI-gestützte Funktionen für die Places API (neu)

Mit diesen Funktionen werden einer Antwort der Places API (New) die folgenden Daten hinzugefügt:

  • Generative Ortszusammenfassungen, die sich auf einen bestimmten Ort beziehen. Ortszusammenfassungen werden von Place Details (New), Text Search (New) und Nearby Search (New) unterstützt.

  • Generative Ortsbeschreibungen, die sich auf einen bestimmten Umkreis um einen Ort beziehen. Gebietszusammenfassungen werden von Place Details (New), Text Search (New) und Nearby Search (New) unterstützt.

  • Ergebnisse der kontextbezogenen Suche werden von Text Search (New) unterstützt und enthalten Daten, die auf dem in der Anfrage übergebenen Suchstring basieren, anstatt auf Daten, die direkt mit einem Ort verknüpft sind. Anhand dieser Daten können Sie nachvollziehen, wie die Antwort mit der Funktion „Text Search (New)“ ermittelt wird.

Generative Ortszusammenfassungen

Generative Ortszusammenfassungen sind für eine Orts-ID spezifisch. In Ortszusammenfassungen werden viele verschiedene Datentypen in einer einzigen Zusammenfassung für den Ort zusammengefasst.

Die Places API (neu) bietet zwei Arten von generativen Ortszusammenfassungen:

  • Übersichtszusammenfassungen: Kurze Zusammenfassungen eines Orts, die durchschnittlich etwa 100 Zeichen umfassen und Nutzern einen Überblick über einen Ort bieten.

  • Zusammenfassungen der Beschreibung: Längere Zusammenfassungen eines Orts, die durchschnittlich etwa 400 Zeichen umfassen und einen detaillierten Überblick über die wichtigsten Aspekte des Orts bieten.

Ortszusammenfassungen sind derzeit für Ortstypen verfügbar, die in Unterstützte Typen für die Kategorien Kultur, Unterhaltung und Erholung, Essen und Trinken, Shopping und Sport aufgeführt sind.

Generative Gebietszusammenfassungen

Generative Ortsbeschreibungen werden vom LLM für die nähere Umgebung eines Orts erstellt. Die Gebietsübersicht für einen Ort kann alle Informationen enthalten, die ein Nutzer für eine Entscheidung benötigt, ohne dass er weitere Anfragen stellen muss, um Details zum Gebiet aufzurufen.

Neben einer Beschreibung des Gebiets enthält die Antwort auch eine Liste der Orts-IDs für die in der Beschreibung genannten Orte sowie eine Liste der Orte, sortiert nach verschiedenen Inhaltstypen. Ein Inhaltstyp enthält beispielsweise eine Liste von Orten, die mit Aktivitäten in der Region verbunden sind, und ein anderer eine Liste der Restaurants in der Region.

Gebietszusammenfassungen sind derzeit für Ortstypen verfügbar, die in der Liste der unterstützten Typen für die Kategorie Unterkünfte aufgeführt sind, sowie für die Ortstypen electric_vehicle_charging_station, geocode und premise.

Zusammenfassungen von Orten und Gebieten erstellen

Sowohl die generativen Ortszusammenfassungen als auch die generativen Ortsbereichszusammenfassungen werden häufig von Google offline generiert. Wenn Sie diese Zusammenfassungen offline generieren, können Sie die von Gemini unterstützten Inhalte nutzen und gleichzeitig die gewohnte Leistung der Places API (neu) erzielen.

Google generiert diese Zusammenfassungen regelmäßig neu, damit sie auf den neuesten verfügbaren Informationen basieren. Das bedeutet, dass Sie die neuesten Daten in Ihrem Dienst anzeigen, wenn Sie die API aufrufen.

Kontextbezogene Suchergebnisse

Bei einer „Text Search (New)“-Anfrage werden Informationen über eine Gruppe von Orten auf Grundlage eines Strings zurückgegeben, z. B. „Pizza in München“ oder „Schuhgeschäfte in der Nähe von Hamburg“. Die Antwort der Text Search (New)-Methode enthält eine Liste von Orten, die dem Textstring und ggf. der in der Anfrage festgelegten Standortgewichtung entsprechen.

Wenn Sie der Antwort kontextbezogene Suchergebnisse hinzufügen, enthält sie jetzt Rezensionen, Fotos und Begründungen, die Nutzern helfen, die Fragen zu beantworten:

  • Warum wird dieser Ort in den Ergebnissen angezeigt?
  • Warum sollte ich diesen Ort auswählen?

Angenommen, Sie stellen heute eine Anfrage an „Place Details (New)“, „Text Search (New)“ oder „Nearby Search (New)“, die einen bestimmten Ort in der Antwort enthält. Die Antwortdaten für den Ort sind für alle drei Anfragen gleich, da die zurückgegebenen Daten mit diesem Ort verknüpft sind.

Bei einer Text Search (New) mit den neuen Funktionen kann die Antwort jedoch Daten enthalten, die aus dem Eingabe-Suchstring selbst stammen. Das bedeutet, dass die Ergebnisse der kontextbezogenen Suche für den jeweiligen Abfragestring spezifisch sind. Sie stellen beispielsweise eine „Text Search (New)“-Anfrage mit dem folgenden Abfragestring:

„Scharfes vegetarisches Restaurant in Mountain View, CA“

Lassen Sie alle Eingabeparameter unverändert und ändern Sie nur den Abfragestring in:

„Scharfes veganes Restaurant in Mountain View, CA“

Bei einem Restaurant, das in beiden Antworten erscheint, sind die Antwortdaten zum Ort identisch, da diese Daten mit dem Ort selbst verknüpft sind. Die Ergebnisse der kontextbezogenen Suche sind jedoch für die Suchanfrage eindeutig, da sie aus dem Suchstring abgeleitet werden. Sie können Ihren Nutzern dann die Rezensionen, Fotos und Begründungen aus den kontextbezogenen Suchergebnissen anzeigen, damit sie entscheiden können, welcher Ort in der Antwort am besten zu ihrer Suchanfrage passt.

Gemini-Modellfunktionen für die Places API aktivieren (neu)

Sie müssen die Places API (New) aktivieren, um die Gemini-Modellfunktionen für die Places API (New) zu verwenden. Weitere Informationen finden Sie unter Google Cloud-Projekt einrichten.

Einschränkungen für die experimentelle Version

In dieser Version werden nur Zusammenfassungen zu Orten und Gebieten in den USA auf Englisch unterstützt.

Was ist Gemini?

Weitere Informationen zum Gemini-Modell finden Sie in den häufig gestellten Fragen zu Gemini.

Generative Ortszusammenfassung anfordern

Ortszusammenfassungen sind generative Zusammenfassungen, die vom LLM für einen bestimmten Ort erstellt werden. Die Places API (neu) fügt einer Antwort zwei Arten von Zusammenfassungen hinzu:

  • Übersicht: Generative Zusammenfassungen, die der statischen redaktionellen Zusammenfassung eines Orts ähneln. Generative Kurzzusammenfassungen mit durchschnittlich etwa 100 Zeichen haben mehrere Vorteile:

    • Viele Orte haben keine redaktionellen Zusammenfassungen, sodass sie eine Lücke in den verfügbaren Informationen zu einem Ort schließen.

    • Sie werden vom LLM generiert, sodass der Inhaber des Orts sie nicht verwalten muss.

  • Die generativen Zusammenfassungen für Beschreibungen stammen aus vielen Quellen, einschließlich Rezensionen von Google Maps. Die Beschreibung umfasst durchschnittlich etwa 400 Zeichen und eine Liste mit Rezensionen, die zum Erstellen der langen Beschreibung verwendet wurden.

    Wenn Sie Zusammenfassungen von Beschreibungen manuell erstellen möchten, müssen Sie Daten aus vielen Quellen zusammenführen und dann manuell erstellen und verwalten. Mit den Gemini-Modellfunktionen für die Places API (neu) werden diese Zusammenfassungen aus den LLMs erstellt, um den Umfang und die Aktualität der generierten Inhalte beizubehalten.

Ortszusammenfassungen werden von Place Details (New), Text Search (New) und Nearby Search (New) unterstützt. Wenn Sie die Ortsübersicht in die Antwort aufnehmen möchten, fügen Sie das folgende Feld in die Feldmaske der Anfrage ein:

  • Ortsdetails: generativeSummary

  • Text Search und Nearby Search: places.generativeSummary

Das Feld generativeSummary enthält die folgenden Felder:

  • generativeSummary.overview: Die Übersichtszusammenfassung für die generativen Inhalte.
  • generativeSummary.description: Die Zusammenfassung der generativen Beschreibung.
  • generativeSummary.references: Ein Array mit bis zu fünf Rezensionen, die als Inhalt für die Zusammenfassung der Beschreibung verwendet werden. Wenn keine Beschreibungszusammenfassung vorhanden ist, ist dieses Array leer.
  • overviewFlagContentUri: Ein Link, über den Nutzer ein Problem mit der Übersichtszusammenfassung melden können.
  • descriptionFlagContentUri: Ein Link, über den Nutzer ein Problem mit der Zusammenfassung der Beschreibung melden können.

Beispiel für eine Anfrage zur Übersicht und Zusammenfassung der Beschreibung

In diesem Beispiel wird eine Feldmaske von places.generativeSummary verwendet, um das gesamte generativeSummary-Objekt zurückzugeben, einschließlich der Felder generativeSummary.overview, generativeSummary.description und generativeSummary.references:

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

Die Antwort hat folgendes Format:

{
  "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"
        },
        . . .
}

Beispiel für eine Anfrage zur Übersichtszusammenfassung

In diesem Beispiel für eine Textsuche wird nur die overview-Zusammenfassung für scharfe vegetarische Restaurants in Mountain View, Kalifornien, zurückgegeben:

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

Die Antwort enthält das Feld generativeSummary.overview mit den Werten overview.text und overview.languageCode:

{
  "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"
        }
      }
    },
  . . .
}

Zusammenfassung für generative Bereiche anfordern

Gebietszusammenfassungen sind generative Zusammenfassungen, die vom LLM für die Umgebung eines Orts erstellt werden. Zusammenfassungen von Gebieten können für Nutzer wichtig sein, wenn sie eine Entscheidung über einen Ort treffen.

Angenommen, Sie möchten ein Hotel in einer neuen Stadt buchen. Sie finden zwar ein Hotel, das Ihren Anforderungen entspricht, möchten aber auch mehr über die Gegend um das Hotel erfahren. Anstatt sich eine Karte der Umgebung anzusehen und dann jeden Ort auf der Karte untersuchen zu müssen, können Sie stattdessen eine Gebietsübersicht für das Hotel erstellen.

Gebietszusammenfassungen werden von Place Details (New), Text Search (New) und Nearby Search (New) unterstützt.

Wenn Sie die Gebietsübersicht in die Antwort aufnehmen möchten, fügen Sie Folgendes in die Feldmaske der Anfrage ein:

  • areaSummary (Place Details)
  • places.areaSummary (Text Search und Nearby Search)

Das Feld areaSummary für einen Ort in der Antwort enthält das Feld flagContentUri, mit dem Sie unangemessene Inhalte melden können, damit Google sie entfernen kann. Außerdem enthält es ein Array mit bis zu vier contentBlocks. Das Thema für jeden Block basiert auf dem Typ des Orts:

  • Für eine Ladestation für Elektrofahrzeuge, die als Ort vom Typ electric_vehicle_charging_station definiert ist, sind die Themenblöcke "overview", "coffee", "restaurant" und "store" verfügbar.

  • Für einen Ort mit einem Typ, der durch die Kategorie Unterkunft und die spezifischen Ortstypen geocode und premise definiert ist, sind die Themenblöcke "overview", "activity", "restaurant" und "store" verfügbar.

Beispielanfrage für die Standortübersicht einer Ladestation für Elektrofahrzeuge

In dieser Beispiel-Place Details-Anfrage wird die Gebietsübersicht für eine bestimmte Ladestation für Elektrofahrzeuge in Mountain View zurückgegeben, die durch die Orts-ID ChIJC5b6QKiwj4ARgn2EwlnJnWU gekennzeichnet ist:

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

Die Antwort enthält das Feld areaSummary, einschließlich des Arrays contentBlocks:

  • Das Feld topic gibt den Inhaltsblocktyp an. Da es sich bei dem Ort in diesem Beispiel um eine Ladestation für Elektrofahrzeuge handelt, sind die vier Inhaltsblöcke "overview", "coffee", "restaurant" und "store".

  • Das Feld content enthält die Zusammenfassung für dieses Thema, einschließlich des Sprachcodes.

  • Im Array references werden die Namen der Ortsressourcen im Format places/PLACE_ID angegeben, die für den Inhaltsblock verwendet werden.

{
  "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"
  }
}

Beispielanfrage für eine Ortsübersicht für ein Hotel

In dieser Beispielanfrage für die Textsuche werden Hotels in Mountain View, Kalifornien, angefragt:

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

Die Antwort enthält das Feld areaSummary, einschließlich des contentBlocks-Arrays. Die Antwort für Orte vom Typ „Hotel“ enthält Inhaltsbloöcke für die Themen "overview", "activity", "restaurant" und "store":

{
  "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"
      }
    },
    ...
  ]
}

Kontextbezogene Suchergebnisse anfordern

Die Antwort auf eine Text Search (New)-Anfrage enthält ein Array von Orten, die den Kriterien des eingegebenen Suchstrings entsprechen. Sie können jetzt anhand der Anfrage an die API Daten für die kontextbezogene Suche in der Antwort anfordern.

Zur Unterstützung von kontextbezogenen Zusammenfassungen enthält die Antwort von Text Search (New) ein neues Array namens contextualContents auf derselben Ebene wie das Array places in der Antwort:

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

Jedes Element im contextualContents-Array vom Typ ContextualContent hat dieselbe Arrayposition wie im places-Array. Das Element bei contextualContents[0] entspricht also dem Ort bei places[0].

Jedes Arrayelement enthält die folgenden Arrayfelder:

  • contextualContents.reviews: Ein Array mit bis zu drei Rezensionen.
  • contextualContents.photos: Ein Array mit bis zu fünf Fotos.
  • contextualContents.justifications: Ein Array von Begründungen für den Ort, einschließlich:

    • reviewJustification: Einen Abschnitt einer Nutzerrezension hervorheben, der für einen Endnutzer von Interesse sein könnte.
    • businessAvailabilityAttributesJustification: Enthält Attribute für ein Unternehmen, die für einen Endnutzer von Interesse sein könnten.

Wenn Sie die kontextbezogenen Suchergebnisse in die Antwort aufnehmen möchten, fügen Sie contextualContents in die Feldmaske der Anfrage „Text Search (New)“ ein:

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

Die Antwort enthält das contextualContents-Array für jeden Ort in der Antwort:

{
  "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
          }
        }
      ]
    },
    . . .
  ]
}

Implementierungsleitfaden für Anwendungsfälle aus der Automobilbranche

Aus Sicherheitsgründen empfiehlt Google, generative KI-Zusammenfassungen im Parkmodus für die Nutzung in Autos zu rendern. Wenn im Fahrmodus Zusammenfassungen gerendert werden, sollten die Informationen auf dem Bildschirm einfach, klar und prägnant sein, damit die Aufmerksamkeit des Fahrers schnell wieder auf die Straße gelenkt wird.

  • Maximal 3 Zeilen
  • Maximal 120 Zeichen oder 24 Wörter
  • Mindestgröße der Vorderseite: 24 dp

Insbesondere im Automobilbereich liegt es in der Verantwortung des Entwicklers, generative KI-Zusammenfassungen so zu rendern, dass sie sicher sind und allen lokalen Gesetzen und Bestimmungen entsprechen.

Attribution

Wenn Sie Rezensionen, Fotos und Zusammenfassungen mit generativer KI in Ihrer App anzeigen, einschließlich Zusammenfassungen von Orten und Gebieten, müssen Sie auch die erforderlichen Quellenangaben anzeigen.

Quellenangaben für generierte Zusammenfassungen anzeigen

Wenn Sie in Ihrer App Zusammenfassungen mit generativer KI anzeigen, einschließlich Orts- und Gebietszusammenfassungen, müssen Sie auch die erforderlichen Quellenangaben angeben. In diesem Abschnitt wird beschrieben, wie Sie die Quellenangaben anzeigen, je nachdem, wie Sie die Zusammenfassungen mit generativer KI in Ihrer App anzeigen.

In allen Fällen muss die Attribution korrekte Groß- und Kleinschreibung verwenden. Die Quellenangabe und das Google-Logo müssen allen Farb-, Stil- und Schriftstandards entsprechen. Weitere Informationen zu diesen Standards finden Sie unter Richtlinien für die Places API (neu).

Zusammenfassung mit generativer KI im Kontext anderer Google-Daten

In diesem Fall kann die Attribution durch generative KI allein über oder unter der Zusammenfassung angezeigt werden. Die Zuordnung der Inhalte durch Google erfolgt dann an anderer Stelle.

Verwenden Sie für die Quellenangabe den Text „Von KI zusammengefasst“, wie in diesem Bild dargestellt:

Verwenden Sie als Quellenangabe den Text „Von KI zusammengefasst“.

Zusammenfassung mit generativer KI wird einzeln angezeigt

Wenn eine Zusammenfassung mit generativer KI unabhängig von anderen Inhalten aus Google Maps angezeigt wird, muss sie sowohl eine Quellenangabe für die generative KI als auch eine Quellenangabe für Google enthalten, die durch einen Bindestrich getrennt sind. Verwenden Sie für die Quellenangabe den Text „Mithilfe von KI zusammengefasst“ und das Google-Logo, wie in diesem Bild dargestellt:

Wenn die Zusammenfassung separat angezeigt wird, geben Sie die Attribution für generative KI und die Google-Attribution durch ein Semikolon getrennt an.

Zusammenfassung mit generativer KI in einer Liste wiederholt

Wenn Sie eine generierte Zusammenfassung von Orten in einer Liste von Orten wiederholen, gilt Folgendes:

  • Die Liste wird Google zugeordnet
  • Die angezeigten Zusammenfassungen werden mithilfe von KI erstellt.
  • Inhalte sind von Google verfügbar

Die Kennzeichnung sollte über oder unter der Liste in einer einzigen Zeile angezeigt werden. Die KI-Attribution ist links ausgerichtet und die Google-Attribution rechts:

Bei einer Liste sollte die Attribution in einer einzigen Zeile über oder unter der Liste angezeigt werden.

Wenn in einer Liste längere Beschreibungszusammenfassungen mit generativer KI verwendet werden, muss jede Zusammenfassung eine KI-Attribution („Von KI zusammengefasst“ mit dem Infosymbol/der Infoschaltfläche) haben.

Informationen zu einer Zusammenfassung mit generativer KI in einem Dialogfeld anzeigen

Neben einer Zusammenfassung mit generativer KI müssen Sie Endnutzern ein Dialogfeld mit Informationen zur Zusammenfassung und einen Link zum Melden von Problemen mithilfe der eindeutigen Kennung der Zusammenfassung im Feld flagContentUri zur Verfügung stellen. Wenn Sie eine Beschreibungszusammenfassung mit generativer KI verwenden, müssen Sie Informationen zu den Quellen der Zusammenfassung angeben, die sogenannten Referenzen.

Aktivieren Sie den Zugriff auf dieses Dialogfeld, indem Sie ein Infosymbol (als Interaktivitätsaffordance) in Verbindung mit der KI-Attribution einfügen (wie in den Beispielen oben dargestellt) und den Bereich für die KI-Attribution und das Symbol auf Drücken/Klicken reagieren lassen.

Für generative Ortszusammenfassungen Folgendes anzeigen:

Info KI-generierte Ortszusammenfassungen werden aus Google-Rezensionen und anderen Daten erstellt.
Problem melden Wenn Sie Google ein Problem mit dem Inhalt einer Zusammenfassung melden möchten, verwenden Sie den Link im Feld flagContentUri.
Verweise Quellenüberprüfungen

Beispiel:

Informationen zu einer Zusammenfassung mit generativer KI in einem Dialogfeld anzeigen

Für Zusammenfassungen von generativen Gebieten:

Info KI-generierte Gebietszusammenfassungen werden aus Google-Rezensionen und lokalen Daten generiert.
Problem melden Wenn Sie Google ein Problem mit dem Inhalt einer Zusammenfassung melden möchten, verwenden Sie den Link im Feld flagContentUri.

Zusammenfassung der Angabe zum Anzeigenbereich.