Interfejs Geocoding API oferuje podsumowania generowane przez AI, które pomagają użytkownikom zrozumieć miejsce docelowe. Te podsumowania są podawane w obiekcie Destination w polu arrival_summary.
Są to krótkie, łatwe do przejrzenia fragmenty tekstu o długości około 120 znaków lub maksymalnie 24 słów, które zawierają charakterystyczne atrybuty miejsca docelowego, aby pomóc użytkownikom w planowaniu podróży i po przyjeździe.
Na przykład:
- „Za Domino's Pizza ⋅ Średniowysoki budynek mieszkalny z białymi i czerwono-ceglanymi pasami ⋅ Wejście znajduje się za czarną metalową bramą”
- „Wysoki kremowy apartamentowiec z balkonami. Wejście znajduje się pod dużym łukowym mostem nad podjazdem i ma budkę ochrony”.
Podsumowania przyjazdu są generowane przez AI. Podsumowania te mają jednak charakter eksperymentalny i mogą czasami zawierać nieprawidłowe informacje. Użytkownicy nie powinni traktować podsumowań generowanych przez AI jako źródła informacji.
Prośba o podsumowanie przyjazdu
Aby w odpowiedzi otrzymać podsumowanie przyjazdu, w nagłówku X-Goog-FieldMask żądania wyszukiwania miejsc docelowych umieść parametr destinations.arrival_summary.
Pole arrival_summary zawiera obiekt ArrivalSummary z tymi polami: text, flag_content_url i disclosure_text.
Odpowiedź ma postać:
{ "destinations": [ { "arrival_summary": { "text": { "text": "Behind Domino's Pizza ⋅ Mid-rise apartment building with white and brick-red stripes ⋅ Entrance is behind a black metal gate", "languageCode": "en-US" }, "flag_content_url": "https://www.google.com/local/review/rap/report?postId=...", "disclosure_text": { "text": "Summarized with Gemini", "languageCode": "en-US" } } } ] }
Wyświetlanie podsumowań wygenerowanych przez AI
Gdy wyświetlasz w aplikacji podsumowania wygenerowane przez AI, musisz dodać wymagany tekst informacyjny i link do zgłaszania problemów z podsumowaniem.
Tekst informacji
Gdy wyświetlasz podsumowanie oparte na AI z pola text, musisz umieścić zlokalizowany tekst informacji podany w polu disclosure_text obiektu ArrivalSummary w odpowiedzi bezpośrednio pod podsumowaniem. Nigdy nie modyfikuj ani nie rozszerzaj tekstu informacji podanego przez interfejs API.
Zgłaszanie problemów
Każde podsumowanie zawiera ikonę flag_content_url, która umożliwia użytkownikom zgłaszanie problemów z treścią podsumowania. Gdy wyświetlasz podsumowanie wygenerowane przez AI, musisz udostępnić użytkownikom ten link, aby mogli zgłaszać problemy z podsumowaniem.
Więcej informacji znajdziesz w zasadach dotyczących interfejsu Geocoding API.
Zasięg miejsca docelowego
Podsumowania oparte na AI są dostępne tylko w przypadku miejsc docelowych w domach prywatnych w tych obszarach metropolitalnych:
Stany Zjednoczone
- Atlanta
- Boston
- Chicago
- Dallas-Fort Worth
- Houston
- Las Vegas
- Los Angeles
- Miami
- Nowy Jork
- Filadelfia
- San Diego
- San Francisco
- Radom
- Waszyngton DC
Indie
- Bangalore (Bengaluru)
- Madras
- Delhi (Nowe Delhi)
- Hajdarabad
- Kalkuta
- Mumbaj