# Copyright 2025 Google LLC
#
# Licensed under the Apache License, Version 2.0 (the "License");
# you may not use this file except in compliance with the License.
# You may obtain a copy of the License at
#
#     http://www.apache.org/licenses/LICENSE-2.0
#
# Unless required by applicable law or agreed to in writing, software
# distributed under the License is distributed on an "AS IS" BASIS,
# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
# See the License for the specific language governing permissions and
# limitations under the License.
#

# File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.

from typing import List, Optional
from typing_extensions import Literal

from .._models import BaseModel

__all__ = ["GoogleMapsResultStep", "Result", "ResultPlace", "ResultPlaceReviewSnippet"]


class ResultPlaceReviewSnippet(BaseModel):
    """
    Encapsulates a snippet of a user review that answers a question about
    the features of a specific place in Google Maps.
    """

    review_id: Optional[str] = None
    """The ID of the review snippet."""

    title: Optional[str] = None
    """Title of the review."""

    url: Optional[str] = None
    """A link that corresponds to the user review on Google Maps."""


class ResultPlace(BaseModel):
    name: Optional[str] = None

    place_id: Optional[str] = None

    review_snippets: Optional[List[ResultPlaceReviewSnippet]] = None

    url: Optional[str] = None


class Result(BaseModel):
    """The result of the Google Maps."""

    places: Optional[List[ResultPlace]] = None

    widget_context_token: Optional[str] = None


class GoogleMapsResultStep(BaseModel):
    """Google Maps result step."""

    call_id: str
    """Required. ID to match the ID from the function call block."""

    result: List[Result]

    type: Literal["google_maps_result"]

    signature: Optional[str] = None
    """A signature hash for backend validation."""
