@tapline/client 0.2.16 → 0.2.17

package/dist/cjs/services/google_maps/types.d.ts

@@ -0,0 +1,1315 @@
+export interface ErrorDetail {
+    type?: string | null;
+    loc?: (string | number)[] | null;
+    msg?: string | null;
+    input?: unknown | null;
+    ctx?: Record<string, unknown> | null;
+}
+export interface ErrorResponse {
+    code: PublicError;
+    message: string;
+    request_id: string;
+    domain?: string | null;
+    details?: ErrorDetail[] | null;
+    upgrade_url?: string | null;
+}
+export interface GetContributorParams {
+    /** Contributor id, the number in `/maps/contrib/<id>`. */
+    contributor_id: string;
+    /** Latest reviews to include; the profile always lists its 10 latest photos. */
+    limit?: number;
+    /** Google language code for the answer's text. */
+    hl?: string;
+    /** Two-letter region; sets ranking, currency and units. */
+    gl?: string;
+}
+export interface GetDirectionsParams {
+    /** A place, an address or `lat,lng`. */
+    origin: string;
+    /** A place, an address or `lat,lng`. */
+    destination: string;
+    /** How to travel. */
+    travel_mode?: GoogleMapsTravelMode;
+    /** Google language code for the answer's text. */
+    hl?: string;
+    /** Two-letter region; sets ranking, currency and units. */
+    gl?: string;
+}
+export interface GetListParams {
+    /** The `list_id` of a public list, from a list answer or a share link. */
+    list_id: string;
+    /** Google language code for the answer's text. */
+    hl?: string;
+    /** Two-letter region; sets ranking, currency and units. */
+    gl?: string;
+}
+export interface GetPanoramaParams {
+    /** Street View panorama id; photo sphere ids go to `/photos/{photo_id}`. */
+    pano_id: string;
+    /** Google language code for the answer's text. */
+    hl?: string;
+    /** Two-letter region Google answers for. */
+    gl?: string;
+}
+export interface GetPhotoParams {
+    /** A `photo_id` from the place, photos, review or contributor routes. */
+    photo_id: string;
+    /** Google language code for the answer's text. */
+    hl?: string;
+    /** Two-letter region; sets ranking, currency and units. */
+    gl?: string;
+}
+export interface GetPlaceByCidParams {
+    /** Google's customer id of a place, the `?cid=` value, in decimal digits. */
+    cid: string;
+    /** Google language code for the answer's text; hotel check-in and check-out times are read only for `en`. */
+    hl?: string;
+    /** Two-letter region; sets ranking, currency and units. */
+    gl?: string;
+}
+export interface GetPlaceIdsParams {
+    /** Google place id; `ChIJ…` place ids resolve, address and coordinate ids (`Ei…`, `GhIJ…`) answer not_found. */
+    place_id: string;
+}
+export interface GetPlaceParams {
+    /** Google Maps feature id, `0x…:0x…`. */
+    feature_id: string;
+    /** Google language code for the answer's text; hotel check-in and check-out times are read only for `en`. */
+    hl?: string;
+    /** Two-letter region; sets ranking, currency and units. */
+    gl?: string;
+}
+export interface GetPopularTimesParams {
+    /** The place's `kgmid` (`/m/…` or `/g/…`) from the search or place routes. */
+    kgmid: string;
+    /** Google language code for the answer's text; `typical_visit` and `social_posts` are read only for `en`. */
+    hl?: string;
+    /** Two-letter region; sets ranking, currency and units. */
+    gl?: string;
+}
+export interface GetShareLinkParams {
+    /** Code after `maps.app.goo.gl/`. */
+    code: string;
+}
+export interface GetTrafficParams {
+    /** Southern latitude of the box, within ±85.05°. */
+    south: number;
+    /** Western longitude of the box; above `east` when the box crosses 180°. */
+    west: number;
+    /** Northern latitude of the box, within ±85.05°. */
+    north: number;
+    /** Eastern longitude of the box. */
+    east: number;
+    /** Google language code for the answer's text. */
+    hl?: string;
+    /** Two-letter region Google answers for. */
+    gl?: string;
+}
+export interface GetWeatherParams {
+    /** Latitude, within the ±85.05° the map covers. */
+    latitude: number;
+    /** Longitude. */
+    longitude: number;
+    /** Google language code for the answer's text. */
+    hl?: string;
+    /** Two-letter region; `us` answers in °F, most regions in °C. */
+    gl?: string;
+}
+/** A booking or ordering action; `action_url` is Google's own page for the action, `url` the provider's. */
+export interface GoogleMapsActionLink {
+    provider_id: number | null;
+    url: string | null;
+    action_url: string | null;
+    provider: string | null;
+    domain: string | null;
+    action: GoogleMapsCode;
+    logo_url: string | null;
+}
+export interface GoogleMapsAreaRating {
+    rating_type: GoogleMapsCode;
+    value: number;
+}
+export interface GoogleMapsAttributeGroup {
+    group_id: string | null;
+    group: string | null;
+    items: GoogleMapsAttributeItem[];
+}
+export interface GoogleMapsAttributeItem {
+    attribute_id: string | null;
+    label: string | null;
+    value: boolean | null;
+}
+export interface GoogleMapsBoundsEcho {
+    south: number;
+    west: number;
+    north: number;
+    east: number;
+}
+export interface GoogleMapsCode {
+    code: number | string | null;
+    label: string | null;
+}
+/** `weight` is a score Google attaches to the place's link with the region (0.75 to 1.0 seen); its scale is not documented. */
+export interface GoogleMapsContainingRegion {
+    feature_id: string | null;
+    name: string | null;
+    weight: number | null;
+}
+/** `count` is the profile's own tally, `display_count` the number its page shows; Google keeps both and they can differ. */
+export interface GoogleMapsContributionCount {
+    count: number | null;
+    display_count: number | null;
+    contribution_type: GoogleMapsCode;
+}
+export interface GoogleMapsContributor {
+    contributor_id: string | null;
+    name: string | null;
+    description: string | null;
+    url: string;
+    points: number | null;
+    local_guide_level: number | null;
+    current_level_threshold_points: number | null;
+    next_level_threshold_points: number | null;
+    photo_count: number | null;
+    photo_view_count: number | null;
+    contribution_counts: GoogleMapsContributionCount[];
+    is_local_guide: boolean;
+    reviews: GoogleMapsReview[];
+    avatar_url: string | null;
+    photos: GoogleMapsPhoto[];
+    query: GoogleMapsContributorQuery;
+}
+export interface GoogleMapsContributorQuery {
+    contributor_id: string;
+    limit: number;
+    hl: string;
+    gl: string;
+}
+/** A Maps contributor as other records name them: a review author, a photo uploader, a place or list owner. */
+export interface GoogleMapsContributorSummary {
+    contributor_id: string | null;
+    name: string | null;
+    url: string | null;
+    review_count: number | null;
+    photo_count: number | null;
+    local_guide_level: number | null;
+    is_local_guide: boolean | null;
+    avatar_url: string | null;
+}
+export interface GoogleMapsCoordinateQuery {
+    latitude: number;
+    longitude: number;
+    hl: string;
+    gl: string;
+}
+export interface GoogleMapsCoordinates {
+    latitude: number;
+    longitude: number;
+}
+export type GoogleMapsCursorCompletion = "exhausted";
+/** `completion` is null while `next_cursor` is set, else `exhausted`. */
+export interface GoogleMapsCursorPagination {
+    next_cursor: string | null;
+    completion: GoogleMapsCursorCompletion | null;
+}
+/** `busiest_hour` is the earliest hour with the day's highest `busyness_percent`. */
+export interface GoogleMapsDayBusyness {
+    day_of_week: number;
+    day: string | null;
+    busiest_hour: number | null;
+    hourly_busyness: GoogleMapsHourBusyness[];
+}
+/** `day_state` is the row's own code: 1 on a day with hours, 2 on a day whose row reads "Closed". */
+export interface GoogleMapsDayHours {
+    date: string | null;
+    day: string | null;
+    day_of_week: number | null;
+    day_state: GoogleMapsCode;
+    open_hours: GoogleMapsOpenHours[];
+    is_holiday_hours: boolean;
+    holiday: GoogleMapsHoliday | null;
+}
+export interface GoogleMapsDestinationClosure {
+    title: string | null;
+    text: string | null;
+    hours_text: string | null;
+    closing_text: string | null;
+    arrival_at: string | null;
+}
+export interface GoogleMapsDirections {
+    routes: GoogleMapsRoute[];
+    url: string | null;
+    origin: GoogleMapsPlaceSummary | null;
+    destination: GoogleMapsPlaceSummary | null;
+    origin_sub_places: GoogleMapsEndpointPart[];
+    destination_sub_places: GoogleMapsEndpointPart[];
+    destination_closure: GoogleMapsDestinationClosure | null;
+    travel_mode: GoogleMapsCode;
+    durations_by_mode: GoogleMapsModeDuration[];
+    query: GoogleMapsDirectionsQuery;
+}
+export interface GoogleMapsDirectionsQuery {
+    origin: string;
+    destination: string;
+    travel_mode: string;
+    hl: string;
+    gl: string;
+}
+export interface GoogleMapsDirectoryCategory {
+    feature_ids: string[];
+    name: string | null;
+    place_count: number | null;
+}
+export interface GoogleMapsDistance {
+    text: string | null;
+    meters: number | null;
+}
+export interface GoogleMapsDuration {
+    text: string | null;
+    seconds: number | null;
+}
+export interface GoogleMapsDurationRange {
+    text: string | null;
+    min_seconds: number | null;
+    max_seconds: number | null;
+}
+/** A walking or cycling route's height profile; `profile` is the climb or drop over each stretch, in order. */
+export interface GoogleMapsElevation {
+    start_meters: number | null;
+    end_meters: number | null;
+    min_meters: number | null;
+    max_meters: number | null;
+    ascent_meters: number | null;
+    descent_meters: number | null;
+    profile: GoogleMapsElevationStep[];
+}
+export interface GoogleMapsElevationStep {
+    segment_meters: number;
+    elevation_change_meters: number;
+}
+/** A terminal, garage or other part of a directions endpoint; `linked_place` is another place Google ties the part to (code 2 on an airport's rental car centre, label unknown). */
+export interface GoogleMapsEndpointPart {
+    place: GoogleMapsPlaceSummary;
+    linked_place: GoogleMapsLinkedPlace | null;
+}
+/** An event or a dated social post; a post has `post_token` and no `event_id`. */
+export interface GoogleMapsEvent {
+    event_id: string | null;
+    title: string | null;
+    description: string | null;
+    starts_text: string | null;
+    ticket_links: GoogleMapsEventTicketLink[];
+    date_text: string | null;
+    relative_date: string | null;
+    source_account: string | null;
+    post_token: string | null;
+    image: GoogleMapsImage | null;
+    alternate_image: GoogleMapsImage | null;
+}
+export interface GoogleMapsEventTicketLink {
+    url: string | null;
+    seller: string | null;
+    seller_logo_url: string | null;
+}
+export interface GoogleMapsHighlight {
+    text: string | null;
+    details: string[];
+}
+export interface GoogleMapsHistoricalPanorama {
+    pano_id: string | null;
+    captured_at: string | null;
+}
+export interface GoogleMapsHoliday {
+    name: string | null;
+    text: string | null;
+}
+export interface GoogleMapsHotel {
+    hotel_id: string | null;
+    price_insight: GoogleMapsPriceInsight | null;
+    check_in_date: string | null;
+    check_out_date: string | null;
+    check_in_time: string | null;
+    check_out_time: string | null;
+    nearby_hotels: GoogleMapsNearbyLodging[];
+    nearby_vacation_rentals: GoogleMapsNearbyLodging[];
+    nights: number | null;
+    adults: number | null;
+    hotel_class: GoogleMapsCode;
+    offers: GoogleMapsHotelOffer[];
+    amenities: GoogleMapsHotelAmenity[];
+}
+/** `availability` labels come from the amenity names: 2 on "Free …", 3 on "Paid …"; 1 and 8 have no word of their own. */
+export interface GoogleMapsHotelAmenity {
+    name: string | null;
+    is_available: boolean | null;
+    availability: GoogleMapsCode;
+    amenity: GoogleMapsCode;
+}
+export interface GoogleMapsHotelOffer {
+    free_cancellation_until_text: string | null;
+    url: string | null;
+    price: GoogleMapsMoney | null;
+    price_with_taxes: GoogleMapsMoney | null;
+    taxes_and_fees: GoogleMapsMoney | null;
+    seller: string | null;
+    member_deal: GoogleMapsMemberDeal | null;
+    is_official_site: boolean;
+    badges: string[];
+    rooms: GoogleMapsHotelRoom[];
+    seller_logo_url: string | null;
+}
+export interface GoogleMapsHotelRoom {
+    name: string | null;
+    free_cancellation_until_text: string | null;
+    url: string | null;
+    price: GoogleMapsMoney | null;
+    price_with_taxes: GoogleMapsMoney | null;
+}
+/** `busyness_percent` is relative to the place's busiest hour of the week (100). */
+export interface GoogleMapsHourBusyness {
+    busyness_text: string | null;
+    hour: number;
+    busyness_percent: number | null;
+    hour_label: string | null;
+}
+export interface GoogleMapsImage {
+    photo_id: string | null;
+    url: string;
+    width: number | null;
+    height: number | null;
+}
+export interface GoogleMapsImageSize {
+    width: number | null;
+    height: number | null;
+}
+export interface GoogleMapsKgmidQuery {
+    kgmid: string;
+    hl: string;
+    gl: string;
+}
+export interface GoogleMapsLink {
+    url: string;
+    domain: string | null;
+}
+export interface GoogleMapsLinkedPlace {
+    feature_id: string | null;
+    cid: string | null;
+    link_type: GoogleMapsCode;
+}
+export interface GoogleMapsList {
+    list_id: string | null;
+    numeric_list_id: string | null;
+    title: string | null;
+    description: string | null;
+    url: string | null;
+    report_url: string | null;
+    place_count: number | null;
+    created_at: string | null;
+    updated_at: string | null;
+    owner: GoogleMapsContributorSummary | null;
+    places: GoogleMapsListItem[];
+    list_type: GoogleMapsCode;
+    icon: string | null;
+    query: GoogleMapsListQuery;
+}
+export interface GoogleMapsListItem {
+    note: string | null;
+    created_at: string | null;
+    updated_at: string | null;
+    added_by: GoogleMapsContributorSummary | null;
+    place: GoogleMapsPlaceSummary;
+}
+export interface GoogleMapsListQuery {
+    list_id: string;
+    hl: string;
+    gl: string;
+}
+export interface GoogleMapsLocalTime {
+    text: string | null;
+    timestamp: string | null;
+    time_zone: string | null;
+    utc_offset_seconds: number | null;
+}
+export interface GoogleMapsMemberDeal {
+    text: string | null;
+    price: GoogleMapsMoney | null;
+    price_with_taxes: GoogleMapsMoney | null;
+}
+export interface GoogleMapsModeDuration {
+    duration: GoogleMapsDuration | null;
+    travel_mode: GoogleMapsCode;
+}
+export interface GoogleMapsMoney {
+    text: string;
+    amount: number | null;
+    currency: string | null;
+}
+export interface GoogleMapsMoneyRange {
+    min_amount: number | null;
+    max_amount: number | null;
+    currency: string | null;
+}
+export interface GoogleMapsNearPanorama {
+    pano_id: string | null;
+    linked_pano_ids: string[];
+    location: GoogleMapsCoordinates | null;
+    altitude_meters: number | null;
+    orientation: GoogleMapsOrientation | null;
+}
+export interface GoogleMapsNearbyLodging {
+    feature_id: string | null;
+    cid: string | null;
+    kgmid: string | null;
+    name: string | null;
+    summary_text: string | null;
+    distance_text: string | null;
+    price: GoogleMapsMoney | null;
+    rating: number | null;
+    review_count: number | null;
+    location: GoogleMapsPlaceLocation | null;
+    categories: string[];
+    category_gcids: string[];
+    image: GoogleMapsImage | null;
+    image_source_url: string | null;
+}
+export interface GoogleMapsNeighborPanorama {
+    pano_id: string | null;
+    heading: number | null;
+}
+export interface GoogleMapsNotice {
+    notice_id: number | null;
+    title: string | null;
+    status_text: string | null;
+    details: GoogleMapsNoticeDetail[];
+}
+export interface GoogleMapsNoticeDetail {
+    text: string | null;
+    url: string | null;
+}
+/** Local clock times: a range ending at midnight closes at "24:00", one ending after midnight at its next-day time ("00:45"); "Open 24 hours" is 00:00 to 24:00. */
+export interface GoogleMapsOpenHours {
+    text: string;
+    opens: string | null;
+    closes: string | null;
+}
+/** Degrees: `heading` clockwise from north, `pitch` above the horizon (0 level, 90 straight up), `roll` about the view axis as Google sends it. */
+export interface GoogleMapsOrientation {
+    heading: number | null;
+    pitch: number | null;
+    roll: number | null;
+}
+export interface GoogleMapsPanoQuery {
+    pano_id: string;
+    hl: string;
+    gl: string;
+}
+/** `altitude_meters` is the camera's height, `ground_elevation_meters` the ground's; `depth_map` is Google's depth map, base64 as sent. */
+export interface GoogleMapsPanorama {
+    pano_id: string | null;
+    address: string | null;
+    url: string;
+    report_url: string | null;
+    captured_at: string | null;
+    author: GoogleMapsContributorSummary | null;
+    location: GoogleMapsPlaceLocation;
+    nearby_places: GoogleMapsPlaceSummary[];
+    neighbor_panoramas: GoogleMapsNeighborPanorama[];
+    historical_panoramas: GoogleMapsHistoricalPanorama[];
+    referenced_panoramas: GoogleMapsPanoramaRef[];
+    streets: GoogleMapsStreet[];
+    altitude_meters: number | null;
+    ground_elevation_meters: number | null;
+    orientation: GoogleMapsOrientation | null;
+    copyright: string | null;
+    tile_size: GoogleMapsImageSize | null;
+    tile_levels: GoogleMapsImageSize[];
+    depth_map: string | null;
+    image_size: GoogleMapsImageSize | null;
+    query: GoogleMapsPanoQuery;
+}
+export interface GoogleMapsPanoramaArea {
+    panoramas: GoogleMapsNearPanorama[];
+    tile: GoogleMapsTile;
+    query: GoogleMapsCoordinateQuery;
+}
+export interface GoogleMapsPanoramaRef {
+    pano_id: string | null;
+    location: GoogleMapsCoordinates | null;
+    orientation: GoogleMapsOrientation | null;
+}
+export interface GoogleMapsPartnerReview {
+    text: string | null;
+    preview_text: string | null;
+    url: string | null;
+    rating: number | null;
+    created_at: string | null;
+    relative_date: string | null;
+    author_name: string | null;
+    aspects: GoogleMapsPartnerReviewAspect[];
+}
+export interface GoogleMapsPartnerReviewAspect {
+    text: string | null;
+    aspect_type: GoogleMapsCode;
+}
+export interface GoogleMapsPartnerReviews {
+    source_id: number | null;
+    url: string | null;
+    rating: number | null;
+    max_rating: number | null;
+    review_count: number | null;
+    source: string | null;
+    reviews: GoogleMapsPartnerReview[];
+    source_type: string | null;
+    source_logo_url: string | null;
+}
+export interface GoogleMapsPhone {
+    url: string | null;
+    number: string | null;
+    national: string | null;
+    international: string | null;
+    e164: string | null;
+}
+/** `url` is a resized copy (`=w{width}-h{height}` or `=k-no` suffix); `width` and `height` are the original's. A panorama's `altitude_meters` is its camera height. Partner photos have no `photo_id`; Google sends them a separate `thumbnail_url`. */
+export interface GoogleMapsPhoto {
+    photo_id: string | null;
+    photo_short_id: string | null;
+    review_id: string | null;
+    address: string | null;
+    caption: string | null;
+    url: string | null;
+    report_url: string | null;
+    captured_at: string | null;
+    uploaded_at: string | null;
+    relative_upload_date: string | null;
+    author: GoogleMapsContributorSummary | null;
+    place: GoogleMapsPlaceSummary | null;
+    location: GoogleMapsCoordinates | null;
+    media_type: GoogleMapsCode;
+    media_subtype: GoogleMapsCode;
+    imagery_owner: GoogleMapsCode;
+    upload_source: string | null;
+    reference_type: string | null;
+    width: number | null;
+    height: number | null;
+    aspect_ratio: number | null;
+    copyright: string | null;
+    altitude_meters: number | null;
+    orientation: GoogleMapsOrientation | null;
+    thumbnail_url: string | null;
+    video: GoogleMapsVideo | null;
+}
+export type GoogleMapsPhotoCategory = "all" | "latest" | "menu" | "by_owner" | "street_view" | "videos";
+export interface GoogleMapsPhotosPage {
+    photos: GoogleMapsPhoto[];
+    photo_count: number | null;
+    category: GoogleMapsCode;
+    query: GoogleMapsPhotosQuery;
+    pagination: GoogleMapsCursorPagination;
+}
+export interface GoogleMapsPhotosQuery {
+    feature_id: string;
+    category: string;
+    limit: number;
+    hl: string;
+    gl: string;
+}
+/**
+ * `place_kind` is Google's coarse kind code (6 lodging, 9 business, 1 landmark, 0 area); `commerce_kind` is 1 for food and drink and 2 for retail. Google sends no label for either.
+ *
+ * `open_state_changes_at` is the local time the status line next changes: an hour before closing ("Closing soon"), 30 minutes before opening, 24:00 when nothing changes before midnight. `is_operating_business` is false for closed businesses and for areas.
+ */
+export interface GoogleMapsPlace {
+    feature_id: string | null;
+    cid: string | null;
+    place_id: string | null;
+    kgmid: string | null;
+    business_profile_id: string | null;
+    name: string | null;
+    native_name: string | null;
+    address: string | null;
+    description: string | null;
+    short_description: string | null;
+    description_paragraphs: string[];
+    long_description: string | null;
+    card_text: string | null;
+    name_language: string | null;
+    native_name_language: string | null;
+    url: string | null;
+    reviews_url: string | null;
+    website: GoogleMapsLink | null;
+    phone: GoogleMapsPhone | null;
+    reservation_links: GoogleMapsLink[];
+    action_links: GoogleMapsActionLink[];
+    claim_url: string | null;
+    price: GoogleMapsMoney | null;
+    price_level: string | null;
+    rating: number | null;
+    review_count: number | null;
+    rating_counts: GoogleMapsRatingCount[];
+    photo_count: number | null;
+    open_status: string | null;
+    open_state: GoogleMapsCode;
+    open_state_changes_at: string | null;
+    hours: GoogleMapsDayHours[];
+    secondary_hours: GoogleMapsSecondaryHours[];
+    business_status: GoogleMapsCode;
+    is_operating_business: boolean | null;
+    is_claimed: boolean;
+    notices: GoogleMapsNotice[];
+    notice_summaries: string[];
+    posting_restrictions: GoogleMapsPostingRestriction[];
+    location: GoogleMapsPlaceLocation;
+    owner: GoogleMapsContributorSummary | null;
+    located_in: GoogleMapsPlaceSummary | null;
+    area: GoogleMapsPlaceArea | null;
+    containing_regions: GoogleMapsContainingRegion[];
+    places_inside: GoogleMapsPlaceInside[];
+    directory_categories: GoogleMapsDirectoryCategory[];
+    top_reviews: GoogleMapsReview[];
+    review_quotes: GoogleMapsReviewQuote[];
+    partner_reviews: GoogleMapsPartnerReviews[];
+    review_topics: GoogleMapsReviewTopic[];
+    categories: string[];
+    category_gcids: string[];
+    result_type: string | null;
+    result_type_tags: string[];
+    place_kind: GoogleMapsCode;
+    commerce_kind: GoogleMapsCode;
+    attributes: GoogleMapsAttributeGroup[];
+    highlights: GoogleMapsHighlight[];
+    hotel: GoogleMapsHotel | null;
+    travel_times: GoogleMapsTravelTime[];
+    photos: GoogleMapsPhoto[];
+    cover_photos: GoogleMapsPhoto[];
+    other_photos: GoogleMapsPhoto[];
+}
+export interface GoogleMapsPlaceArea {
+    feature_id: string | null;
+    name: string | null;
+    description: string | null;
+    ratings: GoogleMapsAreaRating[];
+}
+export interface GoogleMapsPlaceIds {
+    place_id: string;
+    feature_id: string;
+    cid: string;
+}
+export interface GoogleMapsPlaceInside {
+    feature_id: string | null;
+    cid: string | null;
+    kgmid: string | null;
+    name: string | null;
+    address: string | null;
+    search_url: string | null;
+    price_level: string | null;
+    rating: number | null;
+    review_count: number | null;
+    rating_counts: GoogleMapsRatingCount[];
+    open_status: string | null;
+    hours: GoogleMapsDayHours[];
+    location: GoogleMapsPlaceLocation;
+    categories: string[];
+    category_gcids: string[];
+    image_url: string | null;
+}
+/** Where a place is; address parts the answer doesn't carry are null. */
+export interface GoogleMapsPlaceLocation {
+    building_feature_id: string | null;
+    address_lines: string[];
+    street: string | null;
+    neighborhood: string | null;
+    city: string | null;
+    postal_code: string | null;
+    state: string | null;
+    locality: string | null;
+    country: string | null;
+    country_code: string | null;
+    plus_code: string | null;
+    global_plus_code: string | null;
+    address_with_name: string | null;
+    latitude: number | null;
+    longitude: number | null;
+    time_zone: string | null;
+    entrance: GoogleMapsCoordinates | null;
+    alternate_point: GoogleMapsCoordinates | null;
+    floor: string | null;
+    floor_name: string | null;
+}
+/** A place as other records name it; fields the naming answer doesn't carry are null. */
+export interface GoogleMapsPlaceSummary {
+    feature_id: string | null;
+    cid: string | null;
+    place_id: string | null;
+    kgmid: string | null;
+    name: string | null;
+    address: string | null;
+    url: string | null;
+    price_range: string | null;
+    rating: number | null;
+    review_count: number | null;
+    location: GoogleMapsPlaceLocation | null;
+    categories: string[];
+    category_gcids: string[];
+    thumbnail_url: string | null;
+}
+export interface GoogleMapsPopularDish {
+    kgmid: string | null;
+    name: string | null;
+    url: string | null;
+    is_popular: boolean;
+    photos: GoogleMapsImage[];
+}
+export interface GoogleMapsPopularTimes {
+    kgmid: string;
+    feature_id: string | null;
+    cid: string | null;
+    place_id: string | null;
+    name: string | null;
+    review_summary: GoogleMapsReviewSummary | null;
+    website: GoogleMapsLink | null;
+    popular_times: GoogleMapsDayBusyness[];
+    typical_visit: GoogleMapsTypicalVisit | null;
+    lowest_ticket_price: GoogleMapsMoney | null;
+    price_per_person: GoogleMapsPricePerPerson | null;
+    events: GoogleMapsEvent[];
+    current_day_of_week: number | null;
+    tickets: GoogleMapsTicketSeller[];
+    social_posts: GoogleMapsSocialPost[];
+    social_post_activity: GoogleMapsSocialPostActivity | null;
+    people_also_search: GoogleMapsRelatedSearch[];
+    popular_dishes: GoogleMapsPopularDish[];
+    query: GoogleMapsKgmidQuery;
+}
+export interface GoogleMapsPost {
+    post_id: string | null;
+    post_short_id: string | null;
+    business_profile_id: string | null;
+    post_resource_name: string | null;
+    title: string | null;
+    text: string | null;
+    event_dates_text: string | null;
+    url: string | null;
+    search_url: string | null;
+    report_url: string | null;
+    created_at: string | null;
+    expires_at: string | null;
+    event_starts_at: string | null;
+    event_ends_at: string | null;
+    date_text: string | null;
+    call_to_action: GoogleMapsPostCallToAction | null;
+    post_type: GoogleMapsCode;
+    images: GoogleMapsImage[];
+}
+export interface GoogleMapsPostCallToAction {
+    label: string | null;
+    url: string | null;
+    action_type: GoogleMapsCode;
+}
+/** Google has turned off a kind of contribution for the place; `contribution_codes` names the kind as Google codes it. */
+export interface GoogleMapsPostingRestriction {
+    title: string | null;
+    text: string | null;
+    url: string | null;
+    restriction_type: GoogleMapsCode;
+    contribution_codes: number[];
+}
+export interface GoogleMapsPostsPage {
+    posts: GoogleMapsPost[];
+    place: GoogleMapsPlaceSummary | null;
+    query: GoogleMapsPostsQuery;
+}
+export interface GoogleMapsPostsQuery {
+    feature_id: string;
+    hl: string;
+    gl: string;
+}
+export interface GoogleMapsPriceBucket {
+    price_range: GoogleMapsCode;
+    amount_range: GoogleMapsMoneyRange | null;
+    share_percent: number | null;
+}
+/** `percent_below_typical` is how far the price sits under the typical price, in whole percent; `deal_level` is 1 below 25 % and 2 from 25 %, with no label from Google. */
+export interface GoogleMapsPriceInsight {
+    typical_price: GoogleMapsMoney | null;
+    difference_from_typical_price: GoogleMapsMoney | null;
+    percent_below_typical: number | null;
+    deal_level: GoogleMapsCode;
+}
+export interface GoogleMapsPricePerPerson {
+    text: string | null;
+    report_count: number | null;
+    amount_range: GoogleMapsMoneyRange | null;
+    distribution: GoogleMapsPriceBucket[];
+}
+export interface GoogleMapsQueriedPoint {
+    latitude: number;
+    longitude: number;
+    plus_code: string | null;
+    global_plus_code: string | null;
+}
+export interface GoogleMapsRatingCount {
+    count: number;
+    stars: number;
+}
+export interface GoogleMapsRelatedSearch {
+    search_term: string | null;
+    cids: string[];
+    kgmids: string[];
+}
+/** The root is the address at the point and `location` is that area's centre; `queried_point` holds the point asked for with its own plus codes; `place` is the map feature Google matched it to. */
+export interface GoogleMapsReverseGeocode {
+    feature_id: string | null;
+    name: string | null;
+    address: string | null;
+    location: GoogleMapsPlaceLocation;
+    queried_point: GoogleMapsQueriedPoint;
+    place: GoogleMapsPlace | null;
+    query: GoogleMapsCoordinateQuery;
+}
+export interface GoogleMapsReview {
+    review_id: string | null;
+    text: string | null;
+    preview_text: string | null;
+    language: string | null;
+    original_language_name: string | null;
+    translated_text: string | null;
+    translated_preview_text: string | null;
+    translated_language_name: string | null;
+    url: string | null;
+    report_url: string | null;
+    rating: number | null;
+    max_rating: number | null;
+    like_count: number | null;
+    reaction_counts: GoogleMapsReviewReaction[];
+    created_at: string | null;
+    edited_at: string | null;
+    relative_date: string | null;
+    author: GoogleMapsContributorSummary | null;
+    place: GoogleMapsPlaceSummary | null;
+    details: GoogleMapsReviewDetail[];
+    owner_response: GoogleMapsReviewOwnerResponse | null;
+    source: GoogleMapsReviewSource | null;
+    photos: GoogleMapsPhoto[];
+}
+export interface GoogleMapsReviewAnswer {
+    answer_key: string | null;
+    label: string | null;
+}
+export interface GoogleMapsReviewDetail {
+    question_key: string | null;
+    question: string | null;
+    label: string | null;
+    text: string | null;
+    translated_text: string | null;
+    rating: number | null;
+    answers: GoogleMapsReviewAnswer[];
+    question_type: GoogleMapsCode;
+}
+export interface GoogleMapsReviewOwnerResponse {
+    text: string | null;
+    language: string | null;
+    report_url: string | null;
+    created_at: string | null;
+    relative_date: string | null;
+}
+export interface GoogleMapsReviewQuote {
+    review_id: string | null;
+    text: string | null;
+    rating: number | null;
+    author: GoogleMapsContributorSummary | null;
+}
+export interface GoogleMapsReviewReaction {
+    count: number;
+    reaction: GoogleMapsCode;
+}
+export type GoogleMapsReviewSort = "most_relevant" | "newest" | "highest_rating" | "lowest_rating";
+export interface GoogleMapsReviewSource {
+    name: string | null;
+    logo_url: string | null;
+}
+/** Google's generated summary of a place's reviews; `criticism_text` is its line on what some reviews dislike. */
+export interface GoogleMapsReviewSummary {
+    text: string | null;
+    criticism_text: string | null;
+}
+/** `count_outside_mentions` is a second count Google keeps per topic, often far above `mention_count`; the answer doesn't say what it counts. */
+export interface GoogleMapsReviewTopic {
+    topic_id: string | null;
+    name: string | null;
+    mention_count: number | null;
+    count_outside_mentions: number | null;
+    mention_breakdown: GoogleMapsTopicMentionCount[];
+}
+export interface GoogleMapsReviewsPage {
+    reviews: GoogleMapsReview[];
+    query: GoogleMapsReviewsQuery;
+    pagination: GoogleMapsCursorPagination;
+}
+export interface GoogleMapsReviewsQuery {
+    feature_id: string;
+    sort: string;
+    limit: number;
+    hl: string;
+    gl: string;
+}
+/** Seconds. `duration_in_traffic` is the time Maps shows for leaving now (it equals `durations_by_mode`), `duration_without_traffic` the free-flow time, and `duration` Google's other estimate, which can exceed both. `walking_duration` is the walking time inside a transit route. */
+export interface GoogleMapsRoute {
+    name: string | null;
+    description: string | null;
+    distance: GoogleMapsDistance | null;
+    duration: GoogleMapsDuration | null;
+    duration_in_traffic: GoogleMapsDuration | null;
+    duration_without_traffic: GoogleMapsDuration | null;
+    typical_duration: GoogleMapsDurationRange | null;
+    walking_duration: GoogleMapsDuration | null;
+    fare: GoogleMapsMoney | null;
+    departure_time: GoogleMapsLocalTime | null;
+    arrival_time: GoogleMapsLocalTime | null;
+    transit_agencies: GoogleMapsTransitAgency[];
+    travel_mode: GoogleMapsCode;
+    traffic_level: GoogleMapsCode;
+    time_zone: string | null;
+    time_zone_abbreviation: string | null;
+    notes: string[];
+    alternative_departures: GoogleMapsTransitDeparture[];
+    elevation: GoogleMapsElevation | null;
+    steps: GoogleMapsRouteStep[];
+    path: GoogleMapsCoordinates[];
+    traffic_segments: GoogleMapsTrafficSegment[];
+}
+/** `center_location` is the centre of the map view Google draws for the step. */
+export interface GoogleMapsRouteStep {
+    instruction: string | null;
+    distance: GoogleMapsDistance | null;
+    duration: GoogleMapsDuration | null;
+    center_location: GoogleMapsCoordinates | null;
+    travel_mode: GoogleMapsCode;
+    notes: string[];
+    transit: GoogleMapsTransitDetails | null;
+    sub_steps: GoogleMapsRouteSubStep[];
+    street_view_photo: GoogleMapsPhoto | null;
+}
+/** `maneuver_location` is where the turn happens; `approach_location` a point on the way in, about 20 m before it. */
+export interface GoogleMapsRouteSubStep {
+    instruction: string | null;
+    distance: GoogleMapsDistance | null;
+    duration: GoogleMapsDuration | null;
+    maneuver: string | null;
+    maneuver_location: GoogleMapsCoordinates | null;
+    approach_location: GoogleMapsCoordinates | null;
+    travel_mode: GoogleMapsCode;
+    notes: string[];
+    street_view_photo: GoogleMapsPhoto | null;
+}
+export interface GoogleMapsSearchArea {
+    feature_id: string | null;
+    name: string | null;
+    location: GoogleMapsCoordinates | null;
+}
+export interface GoogleMapsSearchMeta {
+    result_count: number;
+    viewport: GoogleMapsViewport | null;
+    offset: number;
+}
+export interface GoogleMapsSearchPage {
+    results: GoogleMapsPlace[];
+    searched_area: GoogleMapsSearchArea | null;
+    query: GoogleMapsSearchQuery;
+    results_meta: GoogleMapsSearchMeta;
+    pagination: GoogleMapsCursorPagination;
+}
+export interface GoogleMapsSearchQuery {
+    text: string;
+    latitude: number | null;
+    longitude: number | null;
+    zoom: number | null;
+    open_now: boolean;
+    min_rating: number | null;
+    limit: number;
+    hl: string;
+    gl: string;
+}
+export interface GoogleMapsSecondaryHours {
+    type: string | null;
+    schedule: GoogleMapsDayHours[];
+}
+/** `place` when the link opens a place, `list_id` when it opens a list; `url` is where the link redirects. */
+export interface GoogleMapsShareLink {
+    code: string;
+    list_id: string | null;
+    url: string | null;
+    place: GoogleMapsPlaceSummary | null;
+    target_type: GoogleMapsShareLinkTarget;
+}
+export type GoogleMapsShareLinkTarget = "list" | "place" | "directions" | "search" | "other";
+export interface GoogleMapsSocialPost {
+    text: string | null;
+    url: string | null;
+    relative_date: string | null;
+    author: GoogleMapsSocialPostAuthor | null;
+    platform: string | null;
+    media_type: GoogleMapsCode;
+    image: GoogleMapsImage | null;
+}
+export interface GoogleMapsSocialPostActivity {
+    post_count: number | null;
+    counts: number[];
+    page_rendered_at: string | null;
+    post_times: string[];
+}
+export interface GoogleMapsSocialPostAuthor {
+    username: string | null;
+    name: string | null;
+}
+export interface GoogleMapsStreet {
+    feature_id: string | null;
+    name: string | null;
+    headings: number[];
+}
+export interface GoogleMapsSuggestion {
+    feature_id: string | null;
+    cid: string | null;
+    place_id: string | null;
+    kgmid: string | null;
+    text: string | null;
+    main_text: string | null;
+    secondary_text: string | null;
+    location: GoogleMapsPlaceLocation | null;
+    suggestion_type: GoogleMapsCode;
+    main_text_matches: GoogleMapsTextRange[];
+    secondary_text_matches: GoogleMapsTextRange[];
+}
+export interface GoogleMapsSuggestions {
+    suggestions: GoogleMapsSuggestion[];
+    query: GoogleMapsSuggestionsQuery;
+}
+export interface GoogleMapsSuggestionsQuery {
+    text: string;
+    latitude: number | null;
+    longitude: number | null;
+    hl: string;
+    gl: string;
+}
+/** `unit` follows the request's `gl`: fahrenheit for `us`, celsius elsewhere, null where unverified. */
+export interface GoogleMapsTemperature {
+    text: string | null;
+    value: number | null;
+    unit: string | null;
+}
+/** The matched characters of the text, from `start` up to but not including `end`. */
+export interface GoogleMapsTextRange {
+    start: number;
+    end: number;
+}
+export interface GoogleMapsTicketOffer {
+    offer_id: string | null;
+    seller_offer_id: string | null;
+    merchant_id: string | null;
+    title: string | null;
+    url: string | null;
+    price: GoogleMapsMoney | null;
+    booking_reference: string | null;
+    offer_token: string | null;
+    features: GoogleMapsCode[];
+}
+export interface GoogleMapsTicketSeller {
+    seller: string | null;
+    offers: GoogleMapsTicketOffer[];
+    is_official: boolean;
+    seller_logo_url: string | null;
+}
+export interface GoogleMapsTile {
+    x: number;
+    y: number;
+    zoom: number;
+}
+/** A count Google keeps per review topic beside its mention count, keyed by its slot (6 to 9); labels unknown. Slots 7 + 8 + 9 never exceed the mention count. */
+export interface GoogleMapsTopicMentionCount {
+    count: number;
+    mention_type: GoogleMapsCode;
+}
+/** `traffic_level` is `light`, `medium` or `heavy`, read from the report's icon; Google sends no code for it or for the comparison. */
+export interface GoogleMapsTraffic {
+    summary: string | null;
+    comparison_text: string | null;
+    traffic_level: string | null;
+    bounds: GoogleMapsBoundsEcho | null;
+    zoom: number | null;
+    query: GoogleMapsTrafficQuery;
+}
+export interface GoogleMapsTrafficQuery {
+    south: number;
+    west: number;
+    north: number;
+    east: number;
+    hl: string;
+    gl: string;
+}
+/** `path_index` is the first `path` point the segment covers; `speed` comes without a unit. */
+export interface GoogleMapsTrafficSegment {
+    path_index: number | null;
+    step_index: number | null;
+    traffic_level: GoogleMapsCode;
+    speed: number | null;
+}
+export interface GoogleMapsTransitAgency {
+    agency_id: string | null;
+    name: string | null;
+    url: string | null;
+    phone: string | null;
+}
+export interface GoogleMapsTransitDeparture {
+    departure_time: GoogleMapsLocalTime | null;
+    leave_at_time: GoogleMapsLocalTime | null;
+}
+/** `ride_duration` is the time between the departure and the arrival stop; the step's own `duration` adds the wait. */
+export interface GoogleMapsTransitDetails {
+    line_schedule_url: string | null;
+    ride_duration: GoogleMapsDuration | null;
+    stop_count: number | null;
+    departure_stop: GoogleMapsTransitStop | null;
+    arrival_stop: GoogleMapsTransitStop | null;
+    intermediate_stops: GoogleMapsTransitStop[];
+    line_name: string | null;
+    headsign: string | null;
+    vehicle_type: GoogleMapsCode;
+    line_color: string | null;
+    line_text_color: string | null;
+}
+export interface GoogleMapsTransitStop {
+    stop_id: string | null;
+    feature_id: string | null;
+    name: string | null;
+    arrival_time: GoogleMapsLocalTime | null;
+    departure_time: GoogleMapsLocalTime | null;
+    earlier_arrival_time: GoogleMapsLocalTime | null;
+    earlier_departure_time: GoogleMapsLocalTime | null;
+    location: GoogleMapsCoordinates | null;
+}
+export type GoogleMapsTravelMode = "best" | "driving" | "bicycling" | "walking" | "transit";
+/** Travel time from `origin`, the centre of the map view Google answered for, to the place. */
+export interface GoogleMapsTravelTime {
+    duration: GoogleMapsDuration | null;
+    origin: GoogleMapsCoordinates | null;
+    travel_mode: GoogleMapsCode;
+}
+export interface GoogleMapsTypicalVisit {
+    text: string;
+    min_minutes: number | null;
+    max_minutes: number | null;
+}
+export interface GoogleMapsVideo {
+    duration_ms: number | null;
+    variants: GoogleMapsVideoVariant[];
+}
+export interface GoogleMapsVideoVariant {
+    format_id: number | null;
+    url: string;
+    width: number | null;
+    height: number | null;
+}
+export interface GoogleMapsViewport {
+    latitude: number | null;
+    longitude: number | null;
+    altitude_meters: number | null;
+}
+export interface GoogleMapsWeather {
+    feature_id: string | null;
+    name: string | null;
+    temperature: GoogleMapsTemperature | null;
+    condition: GoogleMapsCode;
+    icon_url: string | null;
+    query: GoogleMapsCoordinateQuery;
+}
+export interface ListPanoramasNearParams {
+    /** Latitude, within the ±85.05° the map covers. */
+    latitude: number;
+    /** Longitude. */
+    longitude: number;
+    /** Google language code for the answer's text. */
+    hl?: string;
+    /** Two-letter region Google answers for. */
+    gl?: string;
+}
+export interface ListPhotosParams {
+    /** Google Maps feature id, `0x…:0x…`. */
+    feature_id: string;
+    /** Photo tab to list. */
+    category?: GoogleMapsPhotoCategory;
+    /** Photos per page. */
+    limit?: number;
+    /** `pagination.next_cursor` from the previous page; empty for the first. */
+    cursor?: string;
+    /** Google language code for the answer's text. */
+    hl?: string;
+    /** Two-letter region; sets ranking, currency and units. */
+    gl?: string;
+}
+export interface ListPostsParams {
+    /** Google Maps feature id, `0x…:0x…`. */
+    feature_id: string;
+    /** Google language code for the answer's text. */
+    hl?: string;
+    /** Two-letter region; sets ranking, currency and units. */
+    gl?: string;
+}
+export interface ListReviewsParams {
+    /** Google Maps feature id, `0x…:0x…`. */
+    feature_id: string;
+    /** Review order. */
+    sort?: GoogleMapsReviewSort;
+    /** Reviews per page. */
+    limit?: number;
+    /** `pagination.next_cursor` from the previous page; empty for the first. */
+    cursor?: string;
+    /** Google language code for the answer's text. */
+    hl?: string;
+    /** Two-letter region; sets ranking, currency and units. */
+    gl?: string;
+}
+export interface ListSuggestionsParams {
+    /** Partly typed search text. */
+    query: string;
+    /** Latitude to search around, within the ±85.05° the map covers; send with `longitude`. */
+    latitude?: number | null;
+    /** Longitude to search around; send with `latitude`. */
+    longitude?: number | null;
+    /** Google language code for the answer's text. */
+    hl?: string;
+    /** Two-letter region; sets ranking, currency and units. */
+    gl?: string;
+}
+export type PublicError = "blocked" | "concurrency_exceeded" | "timeout" | "extraction_failed" | "upstream_blocked" | "upstream_unavailable" | "upstream_response_invalid" | "invalid_url_scheme" | "invalid_url_host" | "unauthenticated" | "forbidden" | "resource_forbidden" | "not_found" | "endpoint_retired" | "rate_limited" | "invalid_request" | "invalid_cursor" | "insufficient_credits" | "internal_error";
+export interface ReverseGeocodeParams {
+    /** Latitude, within the ±85.05° the map covers. */
+    latitude: number;
+    /** Longitude. */
+    longitude: number;
+    /** Google language code for the answer's text. */
+    hl?: string;
+    /** Two-letter region; sets ranking, currency and units. */
+    gl?: string;
+}
+export interface SearchParams {
+    /** What to search for, as typed in the Maps search box. */
+    query: string;
+    /** Only places open at the time of the request. */
+    open_now?: boolean;
+    /** Lowest star rating, 2.0 to 4.5 in steps of 0.5. */
+    min_rating?: number | null;
+    /** `pagination.next_cursor` from the previous page; empty for the first. */
+    cursor?: string;
+    /** Latitude to search around, within the ±85.05° the map covers; send with `longitude`. */
+    latitude?: number | null;
+    /** Longitude to search around; send with `latitude`. */
+    longitude?: number | null;
+    /** Map zoom around the point, as in `/maps/@lat,lng,14z`; 14 when omitted. Needs `latitude` and `longitude`. */
+    zoom?: number | null;
+    /** Places per page. */
+    limit?: number;
+    /** Google language code for the answer's text; hotel check-in and check-out times are read only for `en`. */
+    hl?: string;
+    /** Two-letter region; sets ranking, currency and units. */
+    gl?: string;
+}
+//# sourceMappingURL=types.d.ts.map