REST Resource: places

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

string

Nazwa zasobu tego miejsca w formacie places/{placeId}. Może służyć do wyszukiwania miejsca.

string

Niepowtarzalny identyfikator miejsca.

object (LocalizedText)

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

string

Zestaw tagów typów dla tego wyniku. Na przykład „polityczne” i „miejscowość”. 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.

string

Podstawowy typ danego wyniku. Ten typ musi być jednym z typów interfejsu Places API. Na przykład „restauracja”, „kawiarnia”, „lotnisko” itp. Miejsce może mieć tylko jeden typ główny. 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.

object (LocalizedText)

Wyświetlana nazwa typu głównego zlokalizowana na język żądania, jeśli ma to zastosowanie. 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.

string

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

string

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

string

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

string

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

object (AddressComponent)

Powtórzone komponenty dla każdego poziomu miejscowości. Zwróć uwagę na następujące fakty dotyczące tablicy addressKomponenty[] tablicy: – tablica komponentów adresu może zawierać więcej komponentów niż sformatowany adres. – tablica nie musi zawierać wszystkich jednostek politycznych zawierających adres, z wyjątkiem tych uwzględnionych we atrybucie formattedAddress. Aby pobrać wszystkie jednostki polityczne z określonym adresem, należy użyć odwrotnego geokodowania, przesyłając szerokość i długość geograficzną adresu jako parametr w żądaniu. – Nie ma gwarancji, że format odpowiedzi pozostanie taki sam między żądaniami. W szczególności liczba komponentów addressKomponenty różni się w zależności od żądanego adresu i może się z czasem zmieniać dla tego samego adresu. Komponent może zmieniać pozycję w tablicy. Typ komponentu może się zmieniać. Konkretnego komponentu może brakować w późniejszej odpowiedzi.

object (PlusCode)

Plus Code lokalizacji miejsca (szerokość i długość geograficzna).

object (LatLng)

Pozycja tego miejsca.

object (Viewport)

Widoczny obszar umożliwiający wyświetlanie miejsca na mapie średniej wielkości.

number

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

string

Adres URL prowadzący do dodatkowych informacji o tym miejscu.

string

Wiarygodna witryna dotycząca tego miejsca, np. strona główna firmy. Uwaga: w przypadku miejsc będących częścią sieci (np. sklepu IKEA) będzie to zazwyczaj witryna danego sklepu, a nie całej sieci.

object (Review)

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

object (OpeningHours)

W standardowych godzinach pracy.

object (Photo)

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

string

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

enum (BusinessStatus)

Stan firmy dla danego miejsca.

enum (PriceLevel)

Poziom ceny miejsca.

object (Attribution)

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

string

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

string

Kolor tła elementu icon_mask w formacie szesnastkowym, np. #909CE1.

object (OpeningHours)

Godziny pracy w ciągu najbliższych 7 dni (w tym dzisiaj). Ten okres rozpoczyna się o północy w dniu przesłania żądania i kończy o 23:59 po sześciu dniach. To pole zawiera pole podrzędne obejmujące wszystkie godziny specjalne ustawione dla dat z wyjątkowymi godzinami pracy.

object (OpeningHours)

Zawiera szereg wpisów na następne siedem dni, w tym informacje o dodatkowych godzinach pracy firmy. Dodatkowe godziny pracy różnią się od głównych godzin otwarcia firmy. Na przykład w restauracji restauracji można podać godziny otwarcia samochodu lub dostawy jako dodatkowe godziny. To pole wypełnia pole podrzędne typu, które jest pobierane ze wstępnie zdefiniowanej listy typów godzin otwarcia (np. Drive_THROUGH, PICKUP lub TakeOUT) na podstawie rodzajów miejsca. To pole zawiera pole podrzędne obejmujące wszystkie godziny specjalne ustawione dla dat z wyjątkowymi godzinami pracy.

object (OpeningHours)

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

object (LocalizedText)

Zawiera podsumowanie miejsca. Podsumowanie składa się z omówienia tekstowego i w stosownych przypadkach zawiera również kod języka. Tekst podsumowania musi zostać przedstawiony w niezmienionej formie i nie może być modyfikowany.

object (PaymentOptions)

Opcje płatności akceptowane w tym miejscu. Jeśli dane dotyczące opcji płatności są niedostępne, pole opcji płatności nie jest aktywne.

object (ParkingOptions)

Dostępne opcje parkowania.

object (SubDestination)

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

object (FuelOptions)

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

object (EVChargeOptions)

Informacje o opcjach ładowania EV.

integer

Liczba minut przesunięcia strefy czasowej w tym miejscu względem czasu UTC. Wartość ta jest wyrażona w minutach w celu obsługi stref czasowych przesuniętych o ułamki godziny, np.X godz. i 15 minut.

integer

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

boolean

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

boolean

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

boolean

Określa, czy firma oferuje stoliki wewnątrz czy na zewnątrz.

boolean

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

boolean

Określa, czy miejsce obsługuje rezerwacje.

boolean

Określa, czy w tym miejscu serwowane jest śniadanie.

boolean

Określa, czy w miejscu serwowane są lunche.

boolean

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

boolean

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

boolean

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

boolean

Określa, czy w miejscu serwowane są brunche.

boolean

Określa, czy w tym miejscu można zjeść dania wegetariańskie.

boolean

Goście mają do dyspozycji stoliki na świeżym powietrzu.

boolean

W hotelu można posłuchać muzyki na żywo.

boolean

Na miejscu dostępne jest menu dla dzieci.

boolean

Bar serwujący koktajle.

boolean

Lokal serwuje desery.

boolean

Lokal serwuje kawę.

boolean

Miejsce odpowiednie dla dzieci.

boolean

W tym miejscu można przebywać z psami.

boolean

Na miejscu jest toaleta.

boolean

Miejsce jest przeznaczone dla grup.

boolean

Miejsce jest odpowiednie do oglądania transmisji sportowych.

object (AccessibilityOptions)

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

{
  "text": string,
  "languageCode": string
}

string

Zlokalizowany ciąg znaków w języku odpowiadającym językowi languageCode poniżej.

string

Kod języka tekstu BCP-47, np. „en-US” lub „sr-Latn”.

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

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

string

Pełny opis tekstowy lub nazwa komponentu adresu. Na przykład składnik adresu dla kraju Australia może mieć nazwę „long_name” w formacie „Australia”.

string

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

string

Tablica wskazująca typy komponentu adresu.

string

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

{
  "globalCode": string,
  "compoundCode": string
}

string

Globalny (pełny) kod miejsca, np. „9FWM33GV+HQ”, który reprezentuje obszar o wymiarach 1/8000 x 1/8000 stopnia (ok. 14 x 14 metrów).

string

Kod złożony miejsca, np. „33GV+HQ, Ramberg, Norwegia”, który zawiera sufiks kodu globalnego i zastępuje prefiks sformatowaną nazwą jednostki referencyjnej.

{
  "latitude": number,
  "longitude": number
}

number

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

number

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

{
  "low": {
    object (LatLng)
  },
  "high": {
    object (LatLng)
  }
}

object (LatLng)

To pole jest wymagane. Najniższa pozycja widocznego obszaru.

object (LatLng)

To pole jest wymagane. Najwyższy punkt widocznego obszaru.

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

string

Dokument referencyjny reprezentujący opinię o tym miejscu, który może zostać użyty do ponownego wyszukiwania opinii o tym miejscu (nazywany też nazwą „zasobu” interfejsu API: places/{placeId}/reviews/{review}).

string

Ciąg sformatowany ostatnio czas, w którym podano czas sprawdzania w stosunku do bieżącego czasu, w formie odpowiedniej dla danego języka i kraju.

object (LocalizedText)

Zlokalizowany tekst opinii.

object (LocalizedText)

Tekst opinii w oryginalnym języku.

number

Liczba od 1,0 do 5,0, zwana też liczbą gwiazdek.

object (AuthorAttribution)

Autor tej opinii.

string (Timestamp format)

Sygnatura czasowa sprawdzenia.

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

{
  "displayName": string,
  "uri": string,
  "photoUri": string
}

string

Imię i nazwisko autora tekstu Photo lub Review.

string

Identyfikator URI autora elementu Photo lub Review.

string

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

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

object (Period)

W dni powszednie to miejsce jest otwarte. Okresy są ułożone chronologicznie, zaczynając od niedzieli w lokalnej strefie czasowej. Pusta wartość (ale jej brak) oznacza miejsce, które nigdy nie jest otwarte, np. dlatego, że jest tymczasowo zamknięte na czas remontu.

string

Zlokalizowane ciągi znaków opisujące godziny otwarcia tego miejsca, jeden ciąg na każdy dzień tygodnia. To pole jest puste, jeśli godziny są nieznane lub nie można ich przekonwertować na zlokalizowany tekst. Przykład: „Niedz.: 18:00–06:00”

enum (SecondaryHoursType)

Ciąg typu określający typ dodatkowych godzin pracy.

object (SpecialDay)

Uporządkowane informacje na specjalne dni w okresie, który obejmują zwrócone godziny otwarcia. Dni specjalne to dni, które mogą wpływać na godziny otwarcia danego miejsca, np. Boże Narodzenie. Ustaw wartości currentOpeningHours i currentAdditionalOpeningHours, jeśli obowiązują wyjątkowe godziny.

boolean

Czy to miejsce jest teraz otwarte? Zawsze obecna, chyba że brakuje nam danych o porze dnia lub strefie czasowej w przypadku tych godzin otwarcia.

{
  "open": {
    object (Point)
  },
  "close": {
    object (Point)
  }
}

object (Point)

Godzina, o której miejsce zaczyna być otwarte.

object (Point)

Godzina, o której miejsce zaczyna być zamknięte.

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

object (Date)

Data w lokalnej strefie czasowej danego miejsca.

boolean

Wskazuje, czy ten punkt końcowy został obcięty. Obcinanie ma miejsce, gdy rzeczywiste godziny nie mieszczą się w godzinach, w których chcemy cofnąć czas, dlatego skracamy je do tych granic. Dzięki temu zwracane są maksymalnie 24 x 7 godzin, licząc od północy w dniu otrzymania żądania.

integer

Dzień tygodnia jako liczba całkowita z zakresu od 0 do 6. 0 to niedziela, 1 to poniedziałek itd.

integer

Godzina z 2 cyframi. Ma zakres od 00 do 23.

integer

Minuta z 2 cyframi. Ma zakres od 00 do 59.

{
  "year": integer,
  "month": integer,
  "day": integer
}

integer

Rok daty. Wartość musi mieścić się w przedziale od 1 do 9999 lub 0, jeśli chcesz określić datę bez roku.

integer

Miesiąc roku. Należy podać wartość z zakresu od 1 do 12 lub 0, aby określić rok bez miesiąca i dnia.

integer

Dzień miesiąca. Musi mieć wartość od 1 do 31 i być prawidłową w przypadku roku i miesiąca. Możesz też podać 0, aby określić rok lub miesiąc i miesiąc, w których dzień nie ma znaczenia.

{
  "date": {
    object (Date)
  }
}

object (Date)

Data tego wyjątkowego dnia.

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

string

Identyfikator. Dokument referencyjny reprezentujący zdjęcie tego miejsca, który może posłużyć do ponownego wyszukania zdjęcia miejsca (nazywany też nazwą „zasobu” interfejsu API: places/{placeId}/photos/{photo}).

integer

Maksymalna dostępna szerokość w pikselach.

integer

Maksymalna dostępna wysokość w pikselach.

object (AuthorAttribution)

Autorzy tego zdjęcia.

{
  "provider": string,
  "providerUri": string
}

string

Nazwa dostawcy danych o miejscu.

string

Identyfikator URI dostawcy danych miejsca.

{
  "acceptsCreditCards": boolean,
  "acceptsDebitCards": boolean,
  "acceptsCashOnly": boolean,
  "acceptsNfc": boolean
}

boolean

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

boolean

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

boolean

Miejsce akceptuje wyłącznie gotówkę. W miejscach z tym atrybutem nadal mogą być akceptowane inne formy płatności.

boolean

Place akceptuje płatności NFC.

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

boolean

Parking jest wliczony w cenę.

boolean

W ofercie są płatne parkingi.

boolean

Parking przy ulicy jest wliczony w cenę.

boolean

Dostępny jest płatny parking przy ulicy.

boolean

Na terenie obiektu znajduje się parking z obsługą.

boolean

Parking w garażu jest wliczony w cenę.

boolean

Dostępny jest płatny parking w garażu.

{
  "name": string,
  "id": string
}

string

Nazwa zasobu podrzędnego miejsca docelowego.

string

Identyfikator miejsca docelowego.

{
  "wheelchairAccessibleParking": boolean,
  "wheelchairAccessibleEntrance": boolean,
  "wheelchairAccessibleRestroom": boolean,
  "wheelchairAccessibleSeating": boolean
}

boolean

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

boolean

Miejsca mają wejście dla niepełnosprawnych.

boolean

Na miejscu jest toaleta z dostępem dla osób na wózkach.

boolean

Na miejscu znajduje się miejsce na wózek inwalidzki.

{
  "fuelPrices": [
    {
      object (FuelPrice)
    }
  ]
}

object (FuelPrice)

Ostatnia znana cena paliwa dla każdego rodzaju paliwa na tej stacji. Na tej stacji dostępny jest jeden wpis na rodzaj paliwa. Kolejność nie jest ważna.

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

enum (FuelType)

Typ paliwa.

object (Money)

Cena paliwa.

string (Timestamp format)

Czas ostatniej aktualizacji ceny paliwa.

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

{
  "currencyCode": string,
  "units": string,
  "nanos": integer
}

string

Trzyliterowy kod waluty zgodny z normą ISO 4217.

string (int64 format)

Całkowite jednostki kwoty. Jeśli np. currencyCode to "USD", to 1 jednostka to 1 dolar amerykański.

integer

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

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

integer

Liczba złączy na tej stacji. Niektóre porty mogą jednak mieć wiele złączy, ale w danym momencie mogą ładować tylko 1 samochód (np. liczba złączy może być większa od łącznej liczby samochodów, które mogą jednocześnie ładować ładowanie).

object (ConnectorAggregation)

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

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

enum (EVConnectorType)

Typ oprogramowania sprzęgającego tej agregacji.

number

Statyczna maksymalna szybkość ładowania w kW dla każdego złącza w agregacji.

integer

Liczba złączy w tej agregacji.

string (Timestamp format)

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

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

integer

Liczba aktualnie dostępnych wtyczek w tej agregacji.

integer

Liczba oprogramowań sprzęgających w tej agregacji, które są obecnie niedostępne.