Format odpowiedzi dla nowego
Szczegóły miejsca,
Wyszukiwanie w pobliżu,
oraz
Wyszukiwanie tekstowe
Formaty interfejsów API różnią się od formatu istniejących interfejsów API. Główna różnica polega na tym,
formatu obiektu Place
zwracanego przez każdą metodę, jak opisano w
Zmiany w obiekcie Place odpowiedzi.
Dodatkowo pola najwyższego poziomu obiektu odpowiedzi zawierają również dla każdego interfejsu API. Zobacz:
- Zmiany odpowiedzi w wyszukiwarce tekstowej
- Zmiany w odpowiedzi na funkcję Wyszukiwanie w pobliżu
- Zmiany w odpowiedzi na pytanie dotyczące szczegółów
Zmiany w obiekcie Place odpowiedzi
Ta tabela zawiera zmiany w nowej wersji
Place
obiekt
w odpowiedzi na szczegóły miejsca (Nowe),
Wyszukiwanie w pobliżu (nowość) i
Wyszukiwanie tekstowe (nowe) w porównaniu z istniejącym
Place
obiekt.
W przypadku nazw pól nowy obiekt odpowiedzi używa wielkich liter wielbłąda oraz zawiera nowe pola, i zmienia nazwy niektórych istniejących pól.
Pole | Istniejący obiekt Miejsca | Nowy obiekt Place | Uwagi |
---|---|---|---|
Komponent adresu | address_components |
addressComponents |
|
Umieść adres w mikroformatu | 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 |
|
Informacje o pochodzeniu danych | html_attributions |
attributions |
Pole najwyższego poziomu odpowiedzi w istniejących interfejsach API |
Adres URL ikony | icon |
Usunięto. Używaj tych identyfikatorów: iconMaskBaseUri i
iconBackgroundColor Zobacz
Ikony miejsc dla:
znajdziesz więcej informacji. |
|
Kolor tła ikony | icon_background_color |
iconBackgroundColor |
|
URL maski ikony | icon_mask_base_uri |
iconMaskBaseUri |
|
Międzynarodowy numer telefonu | international_phone_number |
internationalPhoneNumber |
|
Tekst nazwy miejsca | name |
displayName |
Tekstowa nazwa miejsca jest teraz dostępna jako displayName.text i
language jako displayName.languageCode |
godziny otwarcia; | opening_hours |
regularOpeningHours |
|
Zdjęcia | photos |
photos |
Format karty photos zmienił się w nowym formacie
Place obiekt. Więcej informacji:
Zmiana 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 wszystkie pozostałe dane | secondary_opening_hours |
currentSecondaryOpeningHours |
|
Typy miejsc | types |
types |
|
URL miejsca w Mapach Google | url |
googleMapsUri |
|
Liczba ocen użytkowników | user_ratings_total |
userRatingCount |
|
Przesunięcie UTC | utc_offset |
utcOffsetMinutes |
|
krótki adres z nazwą ulicy i miejscowości; | vicinity |
shortFormattedAddress |
|
Strona internetowa miejsca | website |
websiteUri |
|
Informacje o dostępie dla osób na wózkach | wheelchair_accessible_entrance |
accessibilityOptions |
wheelchair_accessible_entrance jest teraz o
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 formularzu places/PLACE_ID |
W obecnym interfejsie API pole name zawierało
nazwa miejsca w formie ciągu tekstowego. W nowym interfejsie API te informacje są przechowywane
displayName |
|
Typ miejsca głównego | primaryTypeName |
Nowość | |
Umieść typ podstawowy jako ciąg tekstowy | primaryTypeDisplayName |
Nowość | |
Stałe, dodatkowe godziny otwarcia co tydzień, z wyjątkami i innymi dane | regularSecondaryOpeningHours |
Nowość | |
Opcje płatności akceptowane w danym miejscu | paymentOptions |
Nowość | |
Opcje miejsca parkingowego | parkingOptions |
Nowość | |
Lista podmiejsc docelowych związanych z tym miejscem | subDestinations |
Nowość | |
Najnowsze informacje o opcjach paliwa na stacji benzynowej | fuelOptions |
Nowość | |
Informacje o ładowaniu pojazdu elektrycznego w danym miejscu | evChargeOptions |
Nowość | |
Atrybuty Miejsc | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Nowość |
Zmiany odpowiedzi na wyszukiwanie tekstowe
W poniższej tabeli przedstawiono zmiany wprowadzone w polach najwyższego poziomu
obiekt odpowiedzi
dla istniejącego wyszukiwania tekstowego i
obiekt odpowiedzi
dla wyszukiwania tekstowego (nowość). W przypadku nowego interfejsu API jest to jedyne pole najwyższego poziomu w odpowiedzi
to tablica places
.
Pole | Wyszukiwanie tekstowe (obecne) | Wyszukiwanie tekstowe (nowość) | Uwagi |
---|---|---|---|
Informacje o pochodzeniu danych | html_attributions |
Przeniesiono do nowego obiektu Place dla każdego miejsca jako place.attributions |
|
Tablica miejsc | Tablica results istniejącego obiektu Place |
Tablica places nowego obiektu Place |
|
Stan prośby | status |
Przeniesiono do standardowej odpowiedzi HTTP (kod odpowiedzi HTTP i komunikat) | |
wszelkie komunikaty o błędach. | error_message |
Przeniesiono do standardowej odpowiedzi HTTP (kod odpowiedzi HTTP i komunikat) | |
wszelkie komunikaty informacyjne. | info_messages |
Usunięta | |
Token strony | next_page_token |
Usunięta |
Zmiany odpowiedzi na wyszukiwanie w pobliżu
Poniższa tabela przedstawia zmiany wprowadzone w polach najwyższego poziomu odpowiedzi
dla istniejącego wyszukiwania w pobliżu oraz odpowiedzi
dla funkcji Wyszukiwanie w pobliżu (nowość). W przypadku nowego interfejsu API jedynym polem najwyższego poziomu w
jest tablicą places
.
Pole | Wyszukiwanie w pobliżu (Obecne) | Wyszukiwanie w pobliżu (nowość) | Uwagi |
---|---|---|---|
Informacje o pochodzeniu danych | html_attributions |
Przeniesiono do nowego Miejsca
obiekt dla każdego miejsca jako place.attributions |
|
Tablica miejsc | Tablica results istniejącego obiektu Place |
Tablica places nowej
obiekt Place, |
|
Stan prośby | status |
Przeniesiono do standardowej odpowiedzi HTTP (kod odpowiedzi HTTP i komunikat) | |
wszelkie komunikaty o błędach. | error_message |
Przeniesiono do standardowej odpowiedzi HTTP (kod odpowiedzi HTTP i komunikat) | |
wszelkie komunikaty informacyjne. | info_messages |
Usunięta | |
Token strony | next_page_token |
Usunięta |
Zmiany odpowiedzi na temat informacji o miejscu
Poniższa tabela przedstawia zmiany wprowadzone w polach najwyższego poziomu odpowiedzi
dla istniejących informacji o miejscu oraz odpowiedzi
w celu wyświetlenia szczegółów miejsca (nowego). W przypadku nowego interfejsu API jedynym polem najwyższego poziomu w
jest tablicą places
.
Pole | Szczegóły miejsca (istniejące) | Szczegóły miejsca (nowe) | Uwagi |
---|---|---|---|
Informacje o pochodzeniu danych | html_attributions |
Przeniesiono do nowego Miejsca
obiekt jako attributions |
|
Informacje o miejscu | result zawierający istniejący obiekt Place |
Nowy obiekt Place | |
Stan prośby | status |
Przeniesiono do standardowej odpowiedzi HTTP (kod odpowiedzi HTTP i komunikat) | |
wszelkie komunikaty informacyjne. | info_messages |
Przeniesiono do standardowej odpowiedzi HTTP (kod odpowiedzi HTTP i komunikat) |