Format odpowiedzi interfejsów PlaceDetails, NearbySearch i TextSearch uległ zmianie w stosunku do formatu dotychczasowych interfejsów API. Główna różnica polega na tym, że format obiektu Place zwracanego przez każdą metodę jest inny. Opisany jest on w sekcji Zmiany w obiekcie odpowiedzi Place.
Ponadto w przypadku każdego interfejsu API zmieniono pola najwyższego poziomu obiektu odpowiedzi. Zobacz:
- Zmiany odpowiedzi w wyszukiwarce tekstowej
- Zmiany w odpowiedziach wyszukiwania w pobliżu
- Zmiany w odpowiedziach na zapytanie „Place Details”
Zmiany w obiekcie odpowiedzi „Place”
Tabela pokazuje zmiany w nowym
Place obiekcie
w odpowiedzi na zapytania dotyczące szczegółów miejsca (Nowe), wyszukiwania w pobliżu (Nowe) i wyszukiwania tekstowego (Nowe) w porównaniu z dotychczasowym
Place obiektem.
Nowy obiekt odpowiedzi używa formatu CamelCase do nazw pól, zawiera nowe pola i zmienia nazwy niektórych istniejących pól.
| Pole | Istniejący obiekt Miejsce | Nowy obiekt Miejsce | Uwagi |
|---|---|---|---|
| Element adresu | address_components |
addressComponents |
|
| Adres w formacie mikroformatu miejsca | adr_address |
adrFormatAddress |
|
| Stan 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 |
|
| Umieszczenie informacji o źródle | html_attributions |
attributions |
Pole najwyższego poziomu w odpowiedzi w dotychczasowych interfejsach API |
| Adres URL ikony | icon |
Usunięto. Należy użyć właściwości iconMaskBaseUri i iconBackgroundColor. Więcej informacji znajdziesz w sekcji 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 |
Nazwa tekstowa miejsca jest teraz dostępna jako displayName.text, a language jako displayName.languageCode |
| godziny otwarcia; | opening_hours |
regularOpeningHours |
|
| Zdjęcia | photos |
photos |
Format elementu photos został zmieniony w nowym obiekcie Place. Więcej informacji znajdziesz w artykule Zmienianie odwołań 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 na następny tydzień od dzisiaj, 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 UTC, | utc_offset |
utcOffsetMinutes |
|
| Krótka forma adresu, zawierająca nazwę ulicy i nazwę miejscowości | vicinity |
shortFormattedAddress |
|
| Strona internetowa miejsca | website |
websiteUri |
|
| Informacje o dostępności dla osób na wózkach | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance jest 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 dotychczasowym interfejsie API pole name zawierało nazwę miejsca jako ciąg tekstowy. W nowym interfejsie API te informacje znajdują się w polu displayName. |
|
| Podstawowy typ miejsca | primaryTypeName |
Nowe | |
| Umieść podstawowy typ jako ciąg tekstowy. | primaryTypeDisplayName |
Nowe | |
| regularne tygodniowe godziny otwarcia z wyjątkami i innymi danymi; | regularSecondaryOpeningHours |
Nowe | |
| opcje płatności akceptowane przez dany obiekt; | paymentOptions |
Nowe | |
| Opcje parkowania | parkingOptions |
Nowe | |
| Lista podmiejsc docelowych powiązanych z danym miejscem | subDestinations |
Nowe | |
| Najnowsze informacje o opcjach paliwa na stacji benzynowej | fuelOptions |
Nowe | |
| Informacje o stacji ładowania EV dla danego miejsca | evChargeOptions |
Nowe | |
| Atrybuty miejsc | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Nowe |
Zmiany odpowiedzi w wyszukiwaniu tekstowym
Poniższa tabela zawiera zmiany pól najwyższego poziomu obiektu odpowiedzi w przypadku dotychczasowej wyszukiwarki tekstowej i obiektu odpowiedzi w przypadku wyszukiwarki tekstowej (nowej wersji). W przypadku nowego interfejsu API jedynym polem najwyższego poziomu w odpowiedzi jest tablica places.
| Pole | Wyszukaj tekst (obecna funkcja) | Wyszukaj tekst (nowa funkcja) | Uwagi |
|---|---|---|---|
| Umieszczenie informacji o źródle | html_attributions |
Przeniesione do nowego obiektu Place w przypadku każdego miejsca jako place.attributions |
|
| Tablica miejsc | results tablica istniejącego obiektu Place |
tablica places nowego obiektu Place, |
|
| Stan prośby | status |
Przeniesienie do standardowej odpowiedzi HTTP (kod i wiadomość odpowiedzi HTTP) | |
| komunikaty o błędach, | error_message |
Przeniesienie do standardowej odpowiedzi HTTP (kod i wiadomość odpowiedzi HTTP) | |
| wszelkie wiadomości informacyjne; | info_messages |
Usunięto | |
| Token strony | next_page_token |
Usunięto |
Zmiany odpowiedzi w wyszukiwaniu w pobliżu
Poniższa tabela przedstawia zmiany pól najwyższego poziomu obiektu odpowiedzi w przypadku dotychczasowej usługi wyszukiwania w pobliżu oraz obiektu odpowiedzi w przypadku usługi wyszukiwania w pobliżu (nowej). W przypadku nowego interfejsu API jedynym polem najwyższego poziomu w odpowiedzi jest tablica places.
| Pole | Wyszukiwanie w pobliżu (dotychczasowe) | Wyszukiwanie w pobliżu (nowość) | Uwagi |
|---|---|---|---|
| Umieszczenie informacji o źródle | html_attributions |
Przeniesione do nowego obiektu Miejsce w przypadku każdego miejsca jako place.attributions |
|
| Tablica miejsc | results tablica istniejącego obiektu Place |
tablica places nowego obiektu Place |
|
| Stan prośby | status |
Przeniesienie do standardowej odpowiedzi HTTP (kod i wiadomość odpowiedzi HTTP) | |
| komunikaty o błędach, | error_message |
Przeniesienie do standardowej odpowiedzi HTTP (kod i wiadomość odpowiedzi HTTP) | |
| wszelkie wiadomości informacyjne; | info_messages |
Usunięto | |
| Token strony | next_page_token |
Usunięto |
Zmiany odpowiedzi dotyczącej szczegółów miejsca
Poniższa tabela pokazuje zmiany pól najwyższego poziomu obiektu odpowiedzi w przypadku dotychczasowych informacji o miejscu oraz obiektu odpowiedzi w przypadku informacji o miejscu (nowych). W przypadku nowego interfejsu API jedynym polem najwyższego poziomu w odpowiedzi jest tablica places.
| Pole | Informacje o miejscu (obecne) | Informacje o miejscu (nowe) | Uwagi |
|---|---|---|---|
| Umieszczenie informacji o źródle | html_attributions |
Przeniesiono do nowego obiektu Miejsce jako attributions |
|
| Informacje o miejscu | result zawierający istniejący obiekt Miejsce |
Nowy obiekt Miejsce | |
| Stan prośby | status |
Przeniesienie do standardowej odpowiedzi HTTP (kod i wiadomość odpowiedzi HTTP) | |
| wszelkie wiadomości informacyjne; | info_messages |
Przeniesienie do standardowej odpowiedzi HTTP (kod i wiadomość odpowiedzi HTTP) |