REST Resource: places

Zasób: miejsce

Wszystkie informacje reprezentujące miejsce.

Zapis JSON
{
  "name": string,
  "id": string,
  "displayName": {
    object (LocalizedText)
  },
  "types": [
    string
  ],
  "primaryType": string,
  "primaryTypeDisplayName": {
    object (LocalizedText)
  },
  "nationalPhoneNumber": string,
  "internationalPhoneNumber": string,
  "formattedAddress": string,
  "shortFormattedAddress": string,
  "addressComponents": [
    {
      object (AddressComponent)
    }
  ],
  "plusCode": {
    object (PlusCode)
  },
  "location": {
    object (LatLng)
  },
  "viewport": {
    object (Viewport)
  },
  "rating": number,
  "googleMapsUri": string,
  "websiteUri": string,
  "reviews": [
    {
      object (Review)
    }
  ],
  "regularOpeningHours": {
    object (OpeningHours)
  },
  "photos": [
    {
      object (Photo)
    }
  ],
  "adrFormatAddress": string,
  "businessStatus": enum (BusinessStatus),
  "priceLevel": enum (PriceLevel),
  "attributions": [
    {
      object (Attribution)
    }
  ],
  "iconMaskBaseUri": string,
  "iconBackgroundColor": string,
  "currentOpeningHours": {
    object (OpeningHours)
  },
  "currentSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "regularSecondaryOpeningHours": [
    {
      object (OpeningHours)
    }
  ],
  "editorialSummary": {
    object (LocalizedText)
  },
  "paymentOptions": {
    object (PaymentOptions)
  },
  "parkingOptions": {
    object (ParkingOptions)
  },
  "subDestinations": [
    {
      object (SubDestination)
    }
  ],
  "fuelOptions": {
    object (FuelOptions)
  },
  "evChargeOptions": {
    object (EVChargeOptions)
  },
  "generativeSummary": {
    object (GenerativeSummary)
  },
  "areaSummary": {
    object (AreaSummary)
  },
  "utcOffsetMinutes": integer,
  "userRatingCount": integer,
  "takeout": boolean,
  "delivery": boolean,
  "dineIn": boolean,
  "curbsidePickup": boolean,
  "reservable": boolean,
  "servesBreakfast": boolean,
  "servesLunch": boolean,
  "servesDinner": boolean,
  "servesBeer": boolean,
  "servesWine": boolean,
  "servesBrunch": boolean,
  "servesVegetarianFood": boolean,
  "outdoorSeating": boolean,
  "liveMusic": boolean,
  "menuForChildren": boolean,
  "servesCocktails": boolean,
  "servesDessert": boolean,
  "servesCoffee": boolean,
  "goodForChildren": boolean,
  "allowsDogs": boolean,
  "restroom": boolean,
  "goodForGroups": boolean,
  "goodForWatchingSports": boolean,
  "accessibilityOptions": {
    object (AccessibilityOptions)
  }
}
Pola
name

string

Nazwa zasobu tego miejsca w formacie places/{placeId}. Pozwala wyszukać miejsce.

id

string

Unikalny identyfikator miejsca.

displayName

object (LocalizedText)

Zlokalizowana nazwa miejsca, odpowiednia jako krótki, zrozumiały dla człowieka opis. Na przykład „Google Sydney”, „Starbucks”, „Pyrmont” itp.

types[]

string

Zestaw tagów typów dla tego wyniku. Na przykład „polityczne” i „lokalizację”. Pełną listę możliwych wartości znajdziesz w tabelach A i B na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.

primaryType

string

Podstawowy typ danego wyniku. Ten typ musi być jednym z typów obsługiwanych przez interfejs Places API. Na przykład „restauracja”, „kawiarnia”, „lotnisko” itp. Miejsce może mieć tylko jeden główny typ. Pełną listę możliwych wartości znajdziesz w tabelach A i B na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.

primaryTypeDisplayName

object (LocalizedText)

Wyświetlana nazwa typu podstawowego, w stosownych przypadkach zlokalizowana na język żądania. Pełną listę możliwych wartości znajdziesz w tabelach A i B na stronie https://developers.google.com/maps/documentation/places/web-service/place-types.

nationalPhoneNumber

string

Zrozumiały dla człowieka numer telefonu do danego miejsca w formacie krajowym.

internationalPhoneNumber

string

Zrozumiały dla człowieka numer telefonu do danego miejsca w formacie międzynarodowym.

formattedAddress

string

Pełny, zrozumiały dla człowieka adres tego miejsca.

shortFormattedAddress

string

Krótki, zrozumiały dla człowieka adres tego miejsca.

addressComponents[]

object (AddressComponent)

Powtórzone komponenty dla każdego poziomu lokalizacji. Pamiętaj o tych faktach na temat tablicy addressKomponents[]: – Tablica komponentów adresu może zawierać więcej komponentów niż format formattedAddress. – Tablica nie musi zawierać wszystkich jednostek politycznych zawierających adres oprócz tych zawartych w elemencie formattedAddress. Aby pobrać wszystkie jednostki polityczne, które zawierają konkretny adres, użyj odwrotnego geokodowania, przesyłając jako parametr do żądania szerokość i długość geograficzną adresu. – Nie ma gwarancji, że format odpowiedzi między żądaniami pozostanie taki sam. W szczególności liczba elementów addressKomponent różni się w zależności od żądanego adresu i może się zmieniać z czasem w przypadku tego samego adresu. Komponent może zmienić pozycję w tablicy. Typ komponentu może się zmienić. W późniejszej odpowiedzi może brakować określonego komponentu.

plusCode

object (PlusCode)

Kod plus szerokości i długości geograficznej lokalizacji miejsca.

location

object (LatLng)

Pozycja tego miejsca.

viewport

object (Viewport)

Okienko ekranu do wyświetlania miejsca na mapie o średniej wielkości.

rating

number

Ocena od 1,0 do 5,0 na podstawie opinii użytkowników o tym miejscu.

googleMapsUri

string

Adres URL strony zawierającej więcej informacji o tym miejscu.

websiteUri

string

Wiarygodna witryna tego miejsca, np. firmy stronie głównej. Pamiętaj, że w przypadku miejsc, które są częścią sieci (np. sklepu IKEA), będzie to zwykle witryna pojedynczego sklepu, a nie całej sieci.

reviews[]

object (Review)

Lista opinii o tym miejscu posortowana według trafności. Można zwrócić maksymalnie 5 opinii.

regularOpeningHours

object (OpeningHours)

w standardowych godzinach pracy;

photos[]

object (Photo)

Informacje (w tym referencje) o zdjęciach tego miejsca. Możesz zwrócić maksymalnie 10 zdjęć.

adrFormatAddress

string

Adres miejsca w mikroformatu adr: http://microformats.org/wiki/adr.

businessStatus

enum (BusinessStatus)

Status firmy dla danego miejsca.

priceLevel

enum (PriceLevel)

Poziom cen tego miejsca.

attributions[]

object (Attribution)

Zbiór dostawców danych, który musi być wyświetlany z tym wynikiem.

iconMaskBaseUri

string

Skrócony adres URL maski ikony. Użytkownik może uzyskać dostęp do ikon różnych typów, dodając na końcu sufiks typu (np. „.svg” lub „.png”).

iconBackgroundColor

string

Kolor tła dla ikony_mask w formacie szesnastkowym, np. #909CE1.

currentOpeningHours

object (OpeningHours)

Godziny pracy w najbliższych 7 dniach (w tym dzisiaj). Ten okres rozpoczyna się o północy w dniu żądania i kończy o 23:59 po sześciu dniach. To pole zawiera pole podrzędne wszystkie godziny pracy ustawione dla dat o wyjątkowych godzinach pracy.

currentSecondaryOpeningHours[]

object (OpeningHours)

Zawiera tablicę wpisów dotyczących kolejnych 7 dni z informacjami o dodatkowych godzinach pracy firmy. Godziny dodatkowe różnią się od głównych godzin otwarcia firmy. Na przykład jako dodatkowe godziny otwarcia restauracji możesz podać godziny pracy zmotoryzowanych lub dostawy. To pole wypełnia pole podrzędne typu, które korzysta ze wstępnie zdefiniowanej listy typów godzin otwarcia (np. Drive_THROUGH, PICKUP lub TakeOUT) na podstawie rodzaju miejsca. To pole zawiera pole podrzędne wszystkie godziny pracy ustawione dla dat o wyjątkowych godzinach pracy.

regularSecondaryOpeningHours[]

object (OpeningHours)

Zawiera tablicę wpisów z informacjami o zwykłych dodatkowych godzinach pracy firmy. Godziny dodatkowe różnią się od głównych godzin otwarcia firmy. Na przykład jako dodatkowe godziny otwarcia restauracji możesz podać godziny pracy zmotoryzowanych lub dostawy. To pole wypełnia pole podrzędne typu, które korzysta ze wstępnie zdefiniowanej listy typów godzin otwarcia (np. Drive_THROUGH, PICKUP lub TakeOUT) na podstawie rodzaju miejsca.

editorialSummary

object (LocalizedText)

Zawiera podsumowanie miejsca. Podsumowanie składa się z opisu tekstowego i w razie potrzeby zawiera również kod języka. Tekst podsumowania musi być prezentowany w takiej postaci, w jakiej jest, i nie można go modyfikować.

paymentOptions

object (PaymentOptions)

Opcje płatności akceptowane w danym miejscu. Jeśli dane opcji płatności są niedostępne, pole opcji płatności nie zostanie usunięte.

parkingOptions

object (ParkingOptions)

Dostępne parkingi dostępne w tym miejscu.

subDestinations[]

object (SubDestination)

Lista miejsc docelowych podrzędnych związanych z tym miejscem.

fuelOptions

object (FuelOptions)

Najnowsze informacje o opcjach paliwa na stacji benzynowej. Te informacje są regularnie aktualizowane.

evChargeOptions

object (EVChargeOptions)

Informacje o opcjach ładowania EV.

generativeSummary

object (GenerativeSummary)

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Wygenerowane przez AI podsumowanie miejsca.

areaSummary

object (AreaSummary)

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Wygenerowane przez AI podsumowanie obszaru, w którym znajduje się miejsce.

utcOffsetMinutes

integer

Liczba minut w strefie czasowej tego miejsca różniącej się od czasu UTC. Jest ona wyrażona w minutach, aby umożliwić obsługę stref czasowych z przesunięciem o ułamki godziny, np. X godzin i 15 minut.

userRatingCount

integer

Łączna liczba opinii (z tekstem lub bez) o tym miejscu.

takeout

boolean

Określa, czy firma obsługuje dania na wynos.

delivery

boolean

Określa, czy firma obsługuje dostawę.

dineIn

boolean

Określa, czy firma obsługuje stoliki wewnątrz czy na zewnątrz.

curbsidePickup

boolean

Określa, czy firma obsługuje odbiór na zewnątrz.

reservable

boolean

Określa, czy miejsce obsługuje rezerwacje.

servesBreakfast

boolean

Określa, czy w danym miejscu można zjeść śniadanie.

servesLunch

boolean

Określa, czy w danym miejscu można zjeść lunch.

servesDinner

boolean

Określa, czy w danym miejscu można zjeść kolację.

servesBeer

boolean

Określa, czy w danym miejscu można napić się piwa.

servesWine

boolean

Określa, czy w danym miejscu można napić się wina.

servesBrunch

boolean

Określa, czy w danym miejscu można zjeść brunch.

servesVegetarianFood

boolean

Określa, czy w danym miejscu serwowane są dania wegetariańskie.

outdoorSeating

boolean

W tym miejscu są miejsca do siedzenia na świeżym powietrzu.

liveMusic

boolean

Miejsce z muzyką na żywo.

menuForChildren

boolean

Miejsce ma menu dla dzieci.

servesCocktails

boolean

Restauracja serwuje koktajle.

servesDessert

boolean

To miejsce oferuje desery.

servesCoffee

boolean

Miejsce serwuje kawę.

goodForChildren

boolean

To dobre miejsce dla dzieci.

allowsDogs

boolean

Miejsce zezwala na dostęp psów.

restroom

boolean

Na miejscu jest toaleta.

goodForGroups

boolean

Miejsce jest przeznaczone dla grup.

goodForWatchingSports

boolean

Miejsce odpowiednie do oglądania transmisji sportowych.

accessibilityOptions

object (AccessibilityOptions)

Informacje o ułatwieniach dostępu w danym miejscu.

LocalizedText

Zlokalizowana wersja tekstu w określonym języku.

Zapis JSON
{
  "text": string,
  "languageCode": string
}
Pola
text

string

Zlokalizowany ciąg znaków w języku odpowiadającym languageCode.

languageCode

string

Kod języka BCP-47 (np. „en-US”). czy „sr-Latn”.

Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.

AddressComponent

uporządkowane komponenty tworzące sformatowany adres (jeśli takie informacje są dostępne).

Zapis JSON
{
  "longText": string,
  "shortText": string,
  "types": [
    string
  ],
  "languageCode": string
}
Pola
longText

string

Pełny opis tekstowy lub nazwa komponentu adresu. Na przykład składnik adresu dla kraju w Australii może mieć wartość „long_name” jako „Australia”.

shortText

string

Skrócona nazwa tekstowa komponentu adresu (jeśli jest dostępna). Na przykład komponent adresu dla kraju w Australii może mieć krótką nazwę jako „AU”.

types[]

string

Tablica wskazująca typy komponentu adresu.

languageCode

string

Język użyty do formatowania tych komponentów w formacie CLDR.

PlusCode

Plus Code (http://plus.codes) to odniesienie do lokalizacji w 2 formatach: kod globalny definiujący rozmiar 14 m x 14 m lub mniejszy prostokątny oraz kod złożony, zastępując prefiks lokalizacją referencyjną.

Zapis JSON
{
  "globalCode": string,
  "compoundCode": string
}
Pola
globalCode

string

Globalny (pełny) kod miejsca, np. „9FWM33GV+HQ”, reprezentujący obszar o wymiarach 1/8000 x 1/8000 stopni (ok. 14 x 14 metrów).

compoundCode

string

Kod złożony miejsca, np. „33GV+HQ, Ramberg, Norwegia”, zawierający sufiks kodu globalnego i zastąpienie go sformatowaną nazwą elementu referencyjnego.

LatLng

Obiekt reprezentujący parę szerokości i długości geograficznej. Jest ona wyrażona jako para podwójnej precyzji reprezentująca stopnie szerokości i długości geograficznej. O ile nie wskazano inaczej, ten obiekt musi być zgodny ze standardem WGS84. Wartości muszą mieścić się w znormalizowanych zakresach.

Zapis JSON
{
  "latitude": number,
  "longitude": number
}
Pola
latitude

number

Szerokość geograficzna w stopniach. Musi mieścić się w zakresie [-90,0, +90,0].

longitude

number

Długość geograficzna w stopniach. Musi mieścić się w zakresie od -180,0 do +180,0].

Widoczny obszar

Widoczny obszar o długości i szerokości geograficznej reprezentowany jako dwa przeciwstawne punkty: low i high po przekątnej. Widoczny obszar jest uważany za obszar zamknięty, czyli obejmujący swoją granicę. Granice szerokości geograficznej muszą mieścić się w przedziale od -90 do 90 stopni włącznie, a długość geograficzna musi się mieścić w przedziale od -180 do 180 stopni włącznie. Różne przypadki:

  • Jeśli low = high, widoczny obszar składa się z tego pojedynczego punktu.

  • Jeśli low.longitude > high.longitude, zakres długości geograficznej jest odwrócony (widoczny obszar przecina linię długości geograficznej 180 stopni).

  • Jeśli low.longitude = -180 stopni, a high.longitude = 180 stopni, widoczny obszar obejmuje wszystkie długości geograficzne.

  • Jeśli low.longitude = 180 stopni, a high.longitude = -180 stopni, zakres długości geograficznej jest pusty.

  • Jeśli low.latitude > high.latitude, zakres szerokości geograficznej jest pusty.

Musisz wypełnić pola low i high, a reprezentowane pole nie może być puste (zgodnie z definicjami powyżej). Pusty obszar spowoduje wystąpienie błędu.

Na przykład ten widoczny obszar w całości obejmuje Nowy Jork:

{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }

Zapis JSON
{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}
Pola
low

object (LatLng)

Wymagane. Najniższy punkt widocznego obszaru.

high

object (LatLng)

Wymagane. Najwyższy punkt widocznego obszaru.

Sprawdź

Informacje o opinii o miejscu.

Zapis JSON
{
  "name": string,
  "relativePublishTimeDescription": string,
  "text": {
    object (LocalizedText)
  },
  "originalText": {
    object (LocalizedText)
  },
  "rating": number,
  "authorAttribution": {
    object (AuthorAttribution)
  },
  "publishTime": string
}
Pola
name

string

Plik referencyjny opinii o tym miejscu, który może zostać użyty do ponownego wyszukania opinii o tym miejscu (nazywany również nazwą „zasobu” interfejsu API: places/{placeId}/reviews/{review}).

relativePublishTimeDescription

string

Ciąg znaków zawierający dane z ostatniego czasu, w formie odpowiedniej dla danego języka i kraju, wyrażający czas sprawdzenia w odniesieniu do aktualnej godziny.

text

object (LocalizedText)

Zlokalizowany tekst opinii.

originalText

object (LocalizedText)

Tekst opinii w oryginalnym języku.

rating

number

Liczba z zakresu od 1,0 do 5,0, nazywana również liczbą gwiazdek.

authorAttribution

object (AuthorAttribution)

Autor tej opinii.

publishTime

string (Timestamp format)

Sygnatura czasowa opinii.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

AuthorAttribution

Informacje o autorze danych dotyczących treści generowanych przez użytkowników. Użyto w aplikacjach Photo i Review.

Zapis JSON
{
  "displayName": string,
  "uri": string,
  "photoUri": string
}
Pola
displayName

string

Imię i nazwisko autora dokumentu Photo lub Review.

uri

string

Identyfikator URI autora elementu Photo lub Review.

photoUri

string

Identyfikator URI zdjęcia profilowego autora dokumentu Photo lub Review.

OpeningHours

Informacje o godzinach otwarcia miejsca.

Zapis JSON
{
  "periods": [
    {
      object (Period)
    }
  ],
  "weekdayDescriptions": [
    string
  ],
  "secondaryHoursType": enum (SecondaryHoursType),
  "specialDays": [
    {
      object (SpecialDay)
    }
  ],
  "openNow": boolean
}
Pola
periods[]

object (Period)

Okresy, w których to miejsce jest otwarte w ciągu tygodnia. Okresy są uporządkowane chronologicznie, począwszy od niedzieli w lokalnej strefie czasowej. Pusta wartość (ale nie jej brak) wskazuje miejsce, które nigdy nie jest otwarte, np. bo jest tymczasowo zamknięte z powodu remontów.

weekdayDescriptions[]

string

Zlokalizowane ciągi tekstowe opisujące godziny otwarcia tego miejsca, po 1 ciągu dla każdego dnia tygodnia. To pole będzie puste, jeśli godziny otwarcia są nieznane lub nie można ich przekonwertować na zlokalizowany tekst. Przykład: „Niedz.: 18:00–06:00”

secondaryHoursType

enum (SecondaryHoursType)

Ciąg znaków określający typ dodatkowych godzin otwarcia.

specialDays[]

object (SpecialDay)

Uporządkowane informacje dotyczące specjalnych dni, które wypadają w okresie, który obejmują zwrócone godziny otwarcia. Specjalne dni to dni, które mogą wpływać na godziny pracy danego miejsca, np. Boże Narodzenie Ustaw dla currentOpeningHours i currentAdditionalOpeningHours, jeśli istnieją wyjątkowe godziny.

openNow

boolean

Czy to miejsce jest teraz otwarte? Muszą być zawsze dostępne, chyba że nie mamy informacji o porze dnia lub strefie czasowej tych godzin otwarcia.

Okres

Okres, przez który miejsce ma status openNow.

Zapis JSON
{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}
Pola
open

object (Point)

Godzina otwarcia miejsca.

close

object (Point)

Godzina zamknięcia miejsca.

Punkt

Zmiana stanu punktów.

Zapis JSON
{
  "date": {
    object (Date)
  },
  "truncated": boolean,
  "day": integer,
  "hour": integer,
  "minute": integer
}
Pola
date

object (Date)

Data w lokalnej strefie czasowej miejsca.

truncated

boolean

Określa, czy ten punkt końcowy został obcięty. Obcinanie godzin następuje, gdy rzeczywiste godziny pracy wykraczają poza okresy, między którymi możemy wrócić, dlatego skracamy je z powrotem do tych granic. Dzięki temu zwracane są maksymalnie 24 * 7 godzin od północy dnia żądania.

day

integer

Dzień tygodnia w formie liczby całkowitej z zakresu od 0 do 6. 0 oznacza niedzielę, 1 to poniedziałek itd.

hour

integer

Godzina w 2 cyfrach. Ma zakres od 00 do 23.

minute

integer

Minuta w 2 cyfrach. Ma zakres od 00 do 59.

Data

Reprezentuje całą datę lub jej część, na przykład datę urodzin. Pora dnia i strefa czasowa zostały określone w innym miejscu lub są nieistotne. Data zależy od kalendarza gregoriańskiego. Może to być jedna z tych wartości:

  • Pełna data z wartościami niezerowymi dotyczącymi roku, miesiąca i dnia.
  • Miesiąc i dzień bez roku (np. rocznica).
  • Sam rok z zerowym miesiącem i zerowym dniem.
  • Rok i miesiąc z zerową datą ważności (np. data ważności karty kredytowej).

Podobne typy:

Zapis JSON
{
  "year": integer,
  "month": integer,
  "day": integer
}
Pola
year

integer

Rok daty. Wartość musi mieścić się w zakresie od 1 do 9999 lub od 0 do określenia daty bez roku.

month

integer

Miesiąc w roku. Musi mieścić się w zakresie od 1 do 12 lub 0, jeśli chcesz określić rok bez miesiąca i dnia.

day

integer

Dzień miesiąca. Wartość musi należeć do zakresu od 1 do 31 i jest ważna dla roku i miesiąca. Wartość 0 pozwala określić pojedynczy rok lub rok i miesiąc, w którym dzień nie jest istotny.

SecondaryHoursType

Typ używany do identyfikowania dodatkowych godzin pracy.

Wartości w polu enum
SECONDARY_HOURS_TYPE_UNSPECIFIED Wartość domyślna, gdy typ dodatkowej godziny nie jest określony.
DRIVE_THROUGH Godzina z możliwością zmotoryzowanych w bankach, restauracjach i aptekach.
HAPPY_HOUR Happy hours.
DELIVERY Godzina dostawy.
TAKEOUT Godzina na wynos.
KITCHEN Godzina w kuchni.
BREAKFAST Godzina śniadaniowa.
LUNCH Godzina lunchu.
DINNER Godzina kolacji.
BRUNCH Godzina brunchu.
PICKUP Godzina odbioru.
ACCESS Godziny dostępu do miejsc przechowywania danych.
SENIOR_HOURS Niestandardowe godziny otwarcia dla seniorów.
ONLINE_SERVICE_HOURS Godziny pracy online.

SpecialDay

Uporządkowane informacje dotyczące specjalnych dni, które wypadają w okresie, który obejmują zwrócone godziny otwarcia. Specjalne dni to dni, które mogą wpływać na godziny pracy danego miejsca, np. Boże Narodzenie

Zapis JSON
{
  "date": {
    object (Date)
  }
}
Pola
date

object (Date)

Data tego wyjątkowego dnia.

Zdjęcie

Informacje o zdjęciu miejsca.

Zapis JSON
{
  "name": string,
  "widthPx": integer,
  "heightPx": integer,
  "authorAttributions": [
    {
      object (AuthorAttribution)
    }
  ]
}
Pola
name

string

Identyfikator. Odwołanie reprezentujące zdjęcie tego miejsca, które może zostać użyte do ponownego wyszukania zdjęcia tego miejsca (nazywane również nazwą „zasobu” interfejsu API: places/{placeId}/photos/{photo}).

widthPx

integer

Maksymalna dostępna szerokość w pikselach.

heightPx

integer

Maksymalna dostępna wysokość w pikselach.

authorAttributions[]

object (AuthorAttribution)

Autorzy tego zdjęcia.

BusinessStatus

Status firmy dotyczący miejsca.

Wartości w polu enum
BUSINESS_STATUS_UNSPECIFIED Wartość domyślna. Ta wartość nie jest używana.
OPERATIONAL Placówka funkcjonuje, niekoniecznie otwarta teraz.
CLOSED_TEMPORARILY Obiekt jest tymczasowo zamknięty.
CLOSED_PERMANENTLY Obiekt został zamknięty na stałe.

PriceLevel

Poziom cen tego miejsca.

Wartości w polu enum
PRICE_LEVEL_UNSPECIFIED Poziom cen miejsca jest nieokreślony lub nieznany.
PRICE_LEVEL_FREE Place świadczy bezpłatne usługi.
PRICE_LEVEL_INEXPENSIVE Place świadczy niedrogie usługi.
PRICE_LEVEL_MODERATE Place świadczy usługi w umiarkowanej cenie.
PRICE_LEVEL_EXPENSIVE Place świadczy drogie usługi.
PRICE_LEVEL_VERY_EXPENSIVE Place świadczy bardzo drogie usługi.

Atrybucja

Informacje o dostawcach danych tego miejsca.

Zapis JSON
{
  "provider": string,
  "providerUri": string
}
Pola
provider

string

Nazwa dostawcy danych miejsca.

providerUri

string

Identyfikator URI dostawcy danych Miejsc.

PaymentOptions

Opcje płatności akceptowane w danym miejscu.

Zapis JSON
{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}
Pola
acceptsCreditCards

boolean

Miejsce akceptuje płatności kartą kredytową.

acceptsDebitCards

boolean

Miejsce akceptuje jako płatności karty debetowe.

acceptsCashOnly

boolean

Miejsce akceptuje wyłącznie gotówkę. W przypadku miejsc z tym atrybutem nadal można stosować inne formy płatności.

acceptsNfc

boolean

Miejsce akceptuje płatności NFC.

ParkingOptions

Informacje o opcjach parkowania w tym miejscu. Parking może obsługiwać więcej niż 1 opcję jednocześnie.

Zapis JSON
{
  "freeParkingLot": boolean,
  "paidParkingLot": boolean,
  "freeStreetParking": boolean,
  "paidStreetParking": boolean,
  "valetParking": boolean,
  "freeGarageParking": boolean,
  "paidGarageParking": boolean
}
Pola
freeParkingLot

boolean

Dostępne są wliczone w cenę parkingi.

paidParkingLot

boolean

Miejsce oferuje płatne parkingi.

freeStreetParking

boolean

Parking przy ulicy jest wliczony w cenę.

paidStreetParking

boolean

Miejsce oferuje płatny parking przy ulicy.

valetParking

boolean

Obiekt oferuje parking z obsługą.

freeGarageParking

boolean

Parking w garażu jest wliczony w cenę.

paidGarageParking

boolean

Miejsce oferuje płatny parking w garażu.

SubDestination

Miejsce na nazwę zasobu i identyfikator podmiejsc docelowych związanych z danym miejscem. Na przykład różne terminale to różne miejsca docelowe lotniska.

Zapis JSON
{
  "name": string,
  "id": string
}
Pola
name

string

Nazwa zasobu podrzędnego miejsca docelowego.

id

string

Identyfikator miejsca docelowego podrzędnego miejsca docelowego.

AccessibilityOptions

Informacje o ułatwieniach dostępu w danym miejscu.

Zapis JSON
{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}
Pola
wheelchairAccessibleParking

boolean

Na terenie obiektu znajduje się parking dla osób na wózkach.

wheelchairAccessibleEntrance

boolean

Miejsca mają wejście dostępne dla osób na wózkach.

wheelchairAccessibleRestroom

boolean

Na miejscu jest toaleta dla osób na wózkach.

wheelchairAccessibleSeating

boolean

Na miejscu jest miejsce na wózek inwalidzki.

FuelOptions

Najnowsze informacje o opcjach paliwa na stacji benzynowej. Te informacje są regularnie aktualizowane.

Zapis JSON
{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}
Pola
fuelPrices[]

object (FuelPrice)

Ostatnia znana cena paliwa dla każdego typu paliwa na tej stacji. Istnieje 1 wpis na typ paliwa na tej stacji. Kolejność nie jest ważna.

FuelPrice

Informacje o cenach paliwa danego typu.

Zapis JSON
{
  "type": enum (FuelType),
  "price": {
    object (Money)
  },
  "updateTime": string
}
Pola
type

enum (FuelType)

Rodzaj paliwa.

price

object (Money)

Cena paliwa.

updateTime

string (Timestamp format)

Data ostatniej aktualizacji ceny paliwa.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

FuelType

Rodzaje paliwa.

Wartości w polu enum
FUEL_TYPE_UNSPECIFIED Nieokreślony typ paliwa.
DIESEL Olej napędowy.
REGULAR_UNLEADED Zwykłe bezołowiowe.
MIDGRADE Średniooktanowa.
PREMIUM Premium.
SP91 SP 91.
SP91_E10 SP 91 E10.
SP92 SP 92.
SP95 SP 95.
SP95_E10 SP95 E10.
SP98 SP 98.
SP99 SP 99.
SP100 SP 100.
LPG LPG.
E80 E 80.
E85 E 85.
METHANE Metan.
BIO_DIESEL Bioolej napędowy.
TRUCK_DIESEL Diesla do ciężarówek.

Pieniądze

Reprezentuje kwotę za pomocą jej typu waluty.

Zapis JSON
{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}
Pola
currencyCode

string

Trzyliterowy kod waluty zdefiniowany w normie ISO 4217.

units

string (int64 format)

Całkowita jednostka kwoty. Jeśli na przykład currencyCode to "USD", 1 jednostka to 1 zł.

nanos

integer

Liczba jednostek nano (10^-9) ilości. Wartość musi mieścić się w zakresie od -999 999 999 do +999 999 999 włącznie. Jeśli units ma wartość dodatnią, nanos musi być liczbą dodatnią lub zero. Jeśli units ma wartość 0, nanos może być liczbą dodatnią, zerową lub ujemną. Jeśli units ma wartość ujemną, nanos musi mieć wartość ujemną lub zero. Na przykład -1,75 zł jest przedstawione jako units=-1 i nanos=-750 000 000.

EVChargeOptions

Informacje o stacji ładowania EV na miejscu. Terminologia jest zgodna z https://afdc.energy.gov/fuels/electricity_infrastructure.html 1 portem, w którym można ładować jeden samochód naraz. Jeden port ma co najmniej 1 złącze. Jedna stacja ma co najmniej 1 port.

Zapis JSON
{
  "connectorCount": integer,
  "connectorAggregation": [
    {
      object (ConnectorAggregation)
    }
  ]
}
Pola
connectorCount

integer

Liczba złączy w tej stacji. Niektóre porty mogą mieć kilka złączy, ale w danym momencie można ładować tylko jeden samochód (np. liczba złączy może być większa niż całkowita liczba samochodów, które mogą ładować jednocześnie).

connectorAggregation[]

object (ConnectorAggregation)

Lista agregacji złączy ładowania pojazdów elektrycznych, które zawierają złącza tego samego typu i z tą samą szybkością ładowania.

ConnectorAggregation

Informacje o ładowaniu EV pogrupowane według typu, maxChargeRateKw]. Pokazuje dane o agregacji ładowania pojazdów elektrycznych w złączach, które mają ten sam typ i maksymalną szybkość ładowania w kW.

Zapis JSON
{
  "type": enum (EVConnectorType),
  "maxChargeRateKw": number,
  "count": integer,
  "availabilityLastUpdateTime": string,
  "availableCount": integer,
  "outOfServiceCount": integer
}
Pola
type

enum (EVConnectorType)

Typ oprogramowania sprzęgającego tej agregacji.

maxChargeRateKw

number

Statyczna maksymalna szybkość ładowania (w kW) każdego złącza ujętego w agregacji.

count

integer

Liczba oprogramowania sprzęgającego w tej agregacji.

availabilityLastUpdateTime

string (Timestamp format)

Sygnatura czasowa ostatniej aktualizacji informacji o dostępności oprogramowania sprzęgającego w tej agregacji.

Sygnatura czasowa w RFC3339 UTC „Zulu” z rozdzielczością nanosekundową i maksymalnie 9 cyframi po przecinku. Przykłady: "2014-10-02T15:01:23Z" i "2014-10-02T15:01:23.045123456Z".

availableCount

integer

Liczba oprogramowania sprzęgającego, które są obecnie dostępne w tej agregacji.

outOfServiceCount

integer

Liczba oprogramowania sprzęgającego, które jest obecnie wyłączone w tej agregacji.

EVConnectorType

Na stronie http://ieeexplore.ieee.org/stamp/stamp.jsp?arnumber=6872107 znajdziesz dodatkowe informacje i kontekst na temat typów złączy ładowania EV.

Wartości w polu enum
EV_CONNECTOR_TYPE_UNSPECIFIED Nieokreślone oprogramowanie sprzęgające.
EV_CONNECTOR_TYPE_OTHER Inne typy oprogramowania sprzęgającego.
EV_CONNECTOR_TYPE_J1772 złącze J1772 typu 1,
EV_CONNECTOR_TYPE_TYPE_2 Złącze IEC 62196 typu 2. Często określane jako MENNEKES.
EV_CONNECTOR_TYPE_CHADEMO Oprogramowanie sprzęgające typu CHAdeMO.
EV_CONNECTOR_TYPE_CCS_COMBO_1 Łączny system ładowania (prąd przemienny i prąd stały). Na podstawie SAE. Złącze typu 1 J-1772
EV_CONNECTOR_TYPE_CCS_COMBO_2 Łączny system ładowania (prąd przemienny i prąd stały). Na podstawie złącza Mennekesa typu 2
EV_CONNECTOR_TYPE_TESLA Ogólne oprogramowanie sprzęgające TESLA. Jest to NACS w Ameryce Północnej, ale może nie być NACS w innych częściach świata (np. CCS Combo 2 (CCS2) lub GB/T). Ta wartość jest mniej reprezentatywna dla rzeczywistego typu złącza, ale bardziej odzwierciedla możliwość ładowania pojazdu marki Tesla na stacji ładowania należącej do firmy Tesla.
EV_CONNECTOR_TYPE_UNSPECIFIED_GB_T Typ GB/T odpowiada standardowi GB/T w Chinach. Ten typ obejmuje wszystkie typy GB_T.
EV_CONNECTOR_TYPE_UNSPECIFIED_WALL_OUTLET Nieokreślone gniazdko ścienne.

GenerativeSummary

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Wygenerowane przez AI podsumowanie miejsca.

Zapis JSON
{
  "overview": {
    object (LocalizedText)
  },
  "description": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Pola
overview

object (LocalizedText)

Omówienie miejsca.

description

object (LocalizedText)

Szczegółowy opis miejsca.

references

object (References)

Pliki referencyjne służące do generowania podsumowania opisu.

Pliki referencyjne

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Odniesienie, z którym powiązane są treści wygenerowane przez AI.

Zapis JSON
{
  "reviews": [
    {
      object (Review)
    }
  ],
  "places": [
    string
  ]
}
Pola
reviews[]

object (Review)

Opinie, które służą jako pliki referencyjne.

places[]

string

Lista nazw zasobów miejsc docelowych. Tej nazwy można używać w innych interfejsach API, które akceptują nazwy zasobów Place.

AreaSummary

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Wygenerowane przez AI podsumowanie obszaru, w którym znajduje się miejsce.

Zapis JSON
{
  "contentBlocks": [
    {
      object (ContentBlock)
    }
  ]
}
Pola
contentBlocks[]

object (ContentBlock)

Bloki treści tworzące podsumowanie obszaru. Każdy blok obejmuje osobny temat dotyczący danej okolicy.

ContentBlock

Blok treści, który można wyświetlać pojedynczo.

Zapis JSON
{
  "topic": string,
  "content": {
    object (LocalizedText)
  },
  "references": {
    object (References)
  }
}
Pola
topic

string

temat treści, na przykład „omówienie”; lub „restauracja”.

content

object (LocalizedText)

Treści związane z tematem.

references

object (References)

Funkcja eksperymentalna: więcej informacji znajdziesz na stronie https://developers.google.com/maps/documentation/places/web-service/experimental/places-generative.

Odniesienia, które są powiązane z tym blokiem treści.

Metody

autocomplete

Zwraca prognozy dla podanych danych wejściowych.

get

Pobierz informacje o miejscu na podstawie jego nazwy zasobu, która jest ciągiem znaków w formacie places/{place_id}.

searchNearby

Wyszukiwanie miejsc w pobliżu lokalizacji.

searchText

Tekstowe wyszukiwanie miejsca na podstawie zapytania.