Wprowadzenie
Format odpowiedzi w przypadku interfejsów API
Szczegóły miejsca (nowe),
Wyszukiwanie w pobliżu (nowe),
i
Wyszukiwanie tekstu (nowe)
zmienił się w porównaniu z formatem starszych interfejsów API. Główna różnica polega na
formacie obiektu Place zwracanego przez każdą metodę, co opisano w
Zmiany w obiekcie odpowiedzi Place.
Dodatkowo w przypadku każdego interfejsu API zmieniły się też pola najwyższego poziomu obiektu odpowiedzi. Zobacz:
- Zmiany w odpowiedzi na wyszukiwanie tekstu
- Zmiany w odpowiedzi na wyszukiwanie w pobliżu
- Zmiany w odpowiedzi na informacje o miejscu
Zmiany w obiekcie odpowiedzi Place
W tej tabeli przedstawiono zmiany w nowym
Place obiekcie
w odpowiedzi na żądanie do interfejsów API Szczegóły miejsca (nowe),
Wyszukiwanie w pobliżu (nowe) i
Wyszukiwanie tekstu (nowe) w porównaniu ze starszym
Place obiekcie.
Nowy obiekt odpowiedzi używa notacji camel case w nazwach pól, zawiera nowe pola i zmienia nazwy niektórych starszych pól.
| Pole | Obiekt Places API (starszy) | Obiekt Places API (nowy) | Uwagi |
|---|---|---|---|
| Element adresu | address_components |
addressComponents |
|
| Adres w mikroformacie miejsca | adr_address |
adrFormatAddress |
|
| Status firmy | business_status |
businessStatus |
|
| Godziny otwarcia w przyszłym tygodniu | current_opening_hours |
currentOpeningHours |
|
| Podsumowanie redakcyjne | editorial_summary |
editorialSummary |
|
| Sformatowany adres | formatted_address |
formattedAddress |
|
| Krajowy numer telefonu | formatted_phone_number |
nationalPhoneNumber |
|
| Lokalizacja | geometry.location |
location |
|
| Widoczny obszar | geometry.viewport |
viewport |
|
| Atrybucje miejsca | html_attributions |
attributions |
Pole najwyższego poziomu odpowiedzi w starszych interfejsach API |
| Adres URL ikony | icon |
Usunięto. Użyj iconMaskBaseUri i
iconBackgroundColor. Więcej informacji znajdziesz w artykule
Ikony miejsc. |
|
| Kolor tła ikony | icon_background_color |
iconBackgroundColor |
|
| Adres URL maski ikony | icon_mask_base_uri |
iconMaskBaseUri |
|
| Międzynarodowy numer telefonu | international_phone_number |
internationalPhoneNumber |
|
| Tekstowa nazwa miejsca | name |
displayName |
Tekstowa nazwa miejsca jest teraz dostępna jako displayName.text, a
language jako displayName.languageCode |
| Godziny otwarcia | opening_hours |
regularOpeningHours |
|
| Zdjęcia | photos |
photos |
Format photos zmienił się w nowym
Place obiekcie. Więcej informacji znajdziesz w artykule
Zmiana odniesień do zdjęć. |
| Identyfikator miejsca | place_id |
id |
|
| Plus Code | plus_code |
plusCode |
|
| Poziom cen | price_level |
priceLevel |
|
| Ocena | rating |
rating |
|
| Opinie | reviews |
reviews |
|
| Dodatkowe godziny otwarcia w przyszłym tygodniu od dziś, z wyjątkami i wszystkimi innymi danymi | secondary_opening_hours |
currentSecondaryOpeningHours |
|
| Typy miejsc | types |
types |
|
| Adres URL miejsca w Mapach Google | url |
googleMapsUri |
|
| Liczba ocen użytkowników | user_ratings_total |
userRatingCount |
|
| Przesunięcie względem UTC | utc_offset |
utcOffsetMinutes |
|
| Krótka forma adresu, w tym nazwa ulicy i miejscowości | vicinity |
shortFormattedAddress |
|
| Strona internetowa miejsca | website |
websiteUri |
|
| Informacje o dostępności dla osób na wózkach inwalidzkich | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance znajduje się teraz w
accessibilityOptions.wheelchairAccessibleEntrance |
| Atrybuty miejsc | takeout, delivery, dine_in, curbside_pickup, reservable,
serves_breakfast, serves_lunch, serves_dinner, serves_beer, serves_wine,
serves_brunch, serves_vegetarian_food |
takeout, delivery, dineIn, curbsidePickup, reservable,
servesBreakfast, servesLunch, servesDinner, servesBeer, servesWine,
servesBrunch, servesVegetarianFood |
|
| Nazwa zasobu | Pole name w postaci places/PLACE_ID |
W starszym interfejsie API pole name zawierało nazwę miejsca jako ciąg tekstowy. W nowym interfejsie API te informacje znajdują się w polu
displayName. |
|
| Główny typ miejsca | primaryTypeName |
Nowy | |
| Główny typ miejsca jako ciąg tekstowy | primaryTypeDisplayName |
Nowy | |
| Regularne tygodniowe dodatkowe godziny otwarcia, z wyjątkami i wszystkimi innymi danymi | regularSecondaryOpeningHours |
Nowy | |
| Opcje płatności akceptowane w miejscu | paymentOptions |
Nowy | |
| Opcje parkowania w miejscu | parkingOptions |
Nowy | |
| Lista podrzędnych miejsc docelowych powiązanych z miejscem | subDestinations |
Nowy | |
| Najnowsze informacje o opcjach paliwa na stacji paliw | fuelOptions |
Nowy | |
| Informacje o ładowaniu pojazdów elektrycznych w miejscu | evChargeOptions |
Nowy | |
| Atrybuty miejsc | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Nowy |
Zmiany w odpowiedzi na wyszukiwanie tekstu
W tej tabeli przedstawiono zmiany w polach najwyższego poziomu obiektu odpowiedzi na żądanie do interfejsu API Wyszukiwanie tekstu (starszy) i obiektu odpowiedzi na żądanie do interfejsu API Wyszukiwanie tekstu (nowy). W przypadku nowego interfejsu API jedynym polem najwyższego poziomu w odpowiedzi jest tablica places.
| Pole | Wyszukiwanie tekstu (starsze) | Wyszukiwanie tekstu (nowe) | Uwagi |
|---|---|---|---|
| Atrybucje miejsca | html_attributions |
Przeniesione do nowego Place obiektu dla każdego miejsca jako place.attributions |
|
| Tablica miejsc | Tablica results tablicy starszego obiektu Place |
Tablica places nowego obiektu Place |
|
| Stan żądania | status |
Przeniesione do standardowej odpowiedzi HTTP (kod i komunikat odpowiedzi HTTP) | |
| Wszystkie komunikaty o błędach | error_message |
Przeniesione do standardowej odpowiedzi HTTP (kod i komunikat odpowiedzi HTTP) | |
| Wszystkie komunikaty informacyjne | info_messages |
Usunięto | |
| Token strony | next_page_token |
Usunięto |
Zmiany w odpowiedzi na wyszukiwanie w pobliżu
W tej tabeli przedstawiono zmiany w polach najwyższego poziomu obiektu odpowiedzi na żądanie do interfejsu API Wyszukiwanie w pobliżu (starszy) i obiektu odpowiedzi na żądanie do interfejsu API Wyszukiwanie w pobliżu (nowy). W przypadku nowego interfejsu API jedynym polem najwyższego poziomu w odpowiedzi jest tablica places.
| Pole | Wyszukiwanie w pobliżu (starsze) | Wyszukiwanie w pobliżu (nowe) | Uwagi |
|---|---|---|---|
| Atrybucje miejsca | html_attributions |
Przeniesione do nowego Place
obiektu dla każdego miejsca jako place.attributions |
|
| Tablica miejsc | Tablica results tablicy starszego obiektu Place |
Tablica places tablicy nowego
Place obiektu |
|
| Stan żądania | status |
Przeniesione do standardowej odpowiedzi HTTP (kod i komunikat odpowiedzi HTTP) | |
| Wszystkie komunikaty o błędach | error_message |
Przeniesione do standardowej odpowiedzi HTTP (kod i komunikat odpowiedzi HTTP) | |
| Wszystkie komunikaty informacyjne | info_messages |
Usunięto | |
| Token strony | next_page_token |
Usunięto |
Zmiany w odpowiedzi na informacje o miejscu (nowe)
W tej tabeli przedstawiono zmiany w polach najwyższego poziomu obiektu odpowiedzi na żądanie do interfejsu API Informacje o miejscu (starszy) i obiektu odpowiedzi na żądanie do interfejsu API Informacje o miejscu (nowy). W przypadku nowego interfejsu API jedynym polem najwyższego poziomu w odpowiedzi jest tablica places.
| Pole | Informacje o miejscu (starsze) | Informacje o miejscu (nowe) | Uwagi |
|---|---|---|---|
| Atrybucje miejsca | html_attributions |
Przeniesione do nowego Place
obiektu jako attributions |
|
| Informacje o miejscu (nowe) | result zawierający starszy obiekt Place |
Nowy obiekt Place | |
| Stan żądania | status |
Przeniesione do standardowej odpowiedzi HTTP (kod i komunikat odpowiedzi HTTP) | |
| Wszystkie komunikaty informacyjne | info_messages |
Przeniesione do standardowej odpowiedzi HTTP (kod i komunikat odpowiedzi HTTP) |