Format odpowiedzi dla nowych interfejsów API Place Details,
wyszukiwań w pobliżu i wyszukiwania tekstu został zmieniony i nie różni się od formatu dotychczasowych interfejsów API. Główna różnica polega na formacie obiektu Place
zwracanego przez każdą metodę, zgodnie z opisem w sekcji Zmiany w obiekcie Place w odpowiedzi.
Poza tym w przypadku każdego interfejsu API zmieniły się też pola najwyższego poziomu obiektu odpowiedzi. Zobacz:
- Zmiany odpowiedzi w wynikach wyszukiwania tekstowego
- Zmiany odpowiedzi dotyczące wyszukiwania w pobliżu
- Zmiany w odpowiedziach na informacje o miejscu
Zmiany dotyczące obiektu Place w odpowiedzi
Ta tabela przedstawia zmiany wprowadzone w nowym obiekcie Place
w odpowiedzi dla szczegółów miejsca (nowość), wyszukiwania w pobliżu (nowość) i wyszukiwania tekstowego (nowego) w porównaniu z istniejącym obiektem Place
.
Nowy obiekt odpowiedzi stosuje zapis wielbłądów wielkości liter w nazwach pól, zawiera nowe pola i zmienia nazwy niektórych istniejących pól.
Zaawansowana | Istniejący obiekt Place | Nowy obiekt Place | Uwagi |
---|---|---|---|
Komponent adresu | address_components |
addressComponents |
|
Umieść adres mikroformatu | adr_address |
adrFormatAddress |
|
Stan firmy | business_status |
businessStatus |
|
Godziny otwarcia na następny tydzień | 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 miejscu | html_attributions |
attributions |
Pole najwyższego poziomu odpowiedzi w istniejących interfejsach API |
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 |
|
Nazwa miejsca tekstowego | name |
displayName |
Nazwa miejsca tekstowego jest teraz dostępna jako displayName.text i language jako displayName.languageCode |
godziny otwarcia; | opening_hours |
regularOpeningHours |
|
Zdjęcia | photos |
photos |
W nowym obiekcie Place format photos został zmieniony. Więcej informacji znajdziesz w artykule o zmianie dotyczącej plików referencyjnych dotyczących zdjęć. |
Identyfikator miejsca | place_id |
id |
|
Plus Code | plus_code |
plusCode |
|
Poziom cen | price_level |
priceLevel |
|
Rating, | rating |
rating |
|
Opinie | reviews |
reviews |
|
Dodatkowe godziny otwarcia w przyszłym tygodniu od dziś, z wyjątkami i innymi danymi | 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 względem czasu UTC | utc_offset |
utcOffsetMinutes |
|
Skrócona forma adresu zawierająca nazwę ulicy i miasto | vicinity |
shortFormattedAddress |
|
Witryna miejsca | website |
websiteUri |
|
Informacje o dostępie 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 formularzu places/PLACE_ID |
W istniejącym interfejsie API pole name zawierało nazwę miejsca w postaci ciągu tekstowego. W nowym interfejsie API te informacje znajdują się w pliku displayName . |
|
Miejsce podstawowe | primaryTypeName |
Nowi | |
Umieść typ podstawowy jako ciąg tekstowy | primaryTypeDisplayName |
Nowi | |
Zwykłe cotygodniowe godziny otwarcia, z wyjątkami i innymi danymi | regularSecondaryOpeningHours |
Nowi | |
Opcje płatności akceptowane w tym miejscu | paymentOptions |
Nowi | |
Opcje parkingu | parkingOptions |
Nowi | |
Lista podmiejsc docelowych związanych z tym miejscem | subDestinations |
Nowi | |
Najnowsze informacje o opcjach paliw na stacji benzynowej | fuelOptions |
Nowi | |
Informacje o ładowaniu EV w danym miejscu | evChargeOptions |
Nowi | |
Atrybuty Miejsc | outdoorSeating, liveMusic, menuForChildren, servesCocktails,
servesDessert, servesCoffee, goodForChildren, allowsDogs, restroom,
goodForGroups, goodForWatchingSports |
Nowi |
Zmiany odpowiedzi na wyszukiwanie tekstowe
W tabeli poniżej znajdziesz zmiany w polach najwyższego poziomu obiektu odpowiedzi dla istniejącego wyszukiwania tekstowego i obiektu odpowiedzi dla wyszukiwania tekstowego (Nowy). W przypadku nowego interfejsu API jedynym polem najwyższego poziomu w odpowiedzi jest tablica places
.
Zaawansowana | Wyszukiwanie tekstowe (Obecne) | Wyszukiwanie tekstowe (nowość) | Uwagi |
---|---|---|---|
Informacje o miejscu | html_attributions |
Przeniesiono do nowego obiektu Place dla każdego miejsca jako place.attributions |
|
Różne miejsca | Tablica results istniejącego obiektu Place |
Tablica places nowego obiektu Place |
|
Stan prośby | status |
Przeniesiono do standardowej odpowiedzi HTTP (kod odpowiedzi i komunikat HTTP) | |
Wszelkie komunikaty o błędach | error_message |
Przeniesiono do standardowej odpowiedzi HTTP (kod odpowiedzi i komunikat HTTP) | |
Dowolne komunikaty informacyjne | info_messages |
Usunięta | |
Token strony | next_page_token |
Usunięta |
Zmiany odpowiedzi dotyczące wyszukiwania w pobliżu
W tabeli poniżej znajdziesz zmiany w polach najwyższego poziomu obiektu odpowiedzi dla istniejącego wyszukiwania w pobliżu i obiektu odpowiedzi dla funkcji Wyszukiwanie w pobliżu (nowość). W przypadku nowego interfejsu API jedynym polem najwyższego poziomu w odpowiedzi jest tablica places
.
Zaawansowana | Wyszukiwanie w pobliżu (Obecne) | Wyszukiwanie w pobliżu (nowość) | Uwagi |
---|---|---|---|
Informacje o miejscu | html_attributions |
Przeniesiono do nowego obiektu Place dla każdego miejsca jako place.attributions |
|
Różne miejsca | Tablica results istniejącego obiektu Place |
Tablica places nowego obiektu Place |
|
Stan prośby | status |
Przeniesiono do standardowej odpowiedzi HTTP (kod odpowiedzi i komunikat HTTP) | |
Wszelkie komunikaty o błędach | error_message |
Przeniesiono do standardowej odpowiedzi HTTP (kod odpowiedzi i komunikat HTTP) | |
Dowolne komunikaty informacyjne | info_messages |
Usunięta | |
Token strony | next_page_token |
Usunięta |
Zmiany w odpowiedziach na szczegóły miejsca
W tabeli poniżej znajdziesz zmiany w polach najwyższego poziomu obiektu odpowiedzi dla istniejących szczegółów miejsca i obiektu odpowiedzi dla szczegółów miejsca (nowego). W przypadku nowego interfejsu API jedynym polem najwyższego poziomu w odpowiedzi jest tablica places
.
Zaawansowana | Szczegóły miejsca (istniejące) | Szczegóły miejsca (nowość) | Uwagi |
---|---|---|---|
Informacje o miejscu | html_attributions |
Przeniesiono do nowego obiektu Place jako attributions |
|
Szczegóły miejsca | result zawierający istniejący obiekt Place, |
Nowy obiekt Place | |
Stan prośby | status |
Przeniesiono do standardowej odpowiedzi HTTP (kod odpowiedzi i komunikat HTTP) | |
Dowolne komunikaty informacyjne | info_messages |
Przeniesiono do standardowej odpowiedzi HTTP (kod odpowiedzi i komunikat HTTP) |