Places API obsługuje Szczegóły miejsca. Jeśli znasz już istniejący interfejs Places API, nowa wersja Szczegółów miejsc wprowadza następujące zmiany:
- Maskowanie pól jest wymagane. Musisz określić, które pola mają być zwracane w odpowiedzi. Nie ma domyślnej listy zwróconych pól. Jeśli pominiesz ale metody zwrócą błąd. Więcej informacji znajdziesz w artykule FieldMask.
- Nowe informacje o miejscu obsługują Klucze interfejsu API i OAuth tokeny uwierzytelniania.
- W nowym formacie Szczegóły miejsca obsługiwany jest tylko format odpowiedzi JSON.
- Format odpowiedzi JSON interfejsu API Szczegóły miejsca (nowy) różni się od formatu istniejących interfejsów API. Więcej informacji: Przenieś odpowiedź interfejsu Places API.
W tabeli poniżej znajdziesz parametry w dotychczasowych Szczegółach miejsca, które zostały zmienione lub zmodyfikowane w przypadku nowych Szczegółów miejsca, oraz parametry, które nie są już obsługiwane.
| Bieżący parametr | Nowy parametr | Uwagi |
|---|---|---|
place_id |
places/PLACE_ID |
Ciąg tekstowy places/PLACE_ID to także nazwa zasobu miejsca. W odpowiedzi na żądanie dotyczące szczegółów miejsca (nowa usługa), wyszukiwania w pobliżu (nowa usługa) i wyszukiwania tekstowego (nowa usługa) ten ciąg tekstowy znajduje się w polu name odpowiedzi.
Samodzielny identyfikator miejsca znajduje się w polu id odpowiedzi. |
language |
languageCode |
|
region |
regionCode |
Przykładowe żądanie
W tym przykładowym żądaniu GET jest używane
Szczegóły miejsca. W tym przykładzie wysyłasz żądanie przesłania pliku JSON
odpowiedź zawierająca informacje o identyfikatorze miejsca i przekazywać wszystkie parametry jako URL
. W tym przykładzie użyto też fields, więc odpowiedź zawiera tylko nazwę wyświetlaną i sformatowany adres miejsca:
curl -L -X GET \ 'https://maps.googleapis.com/maps/api/place/details/json?place_id=ChIJj61dQgK6j4AR4GeTYWZsKWw&fields=name%2Cformatted_address&key=API_KEY'
Przy użyciu informacji o miejscu (nowych) przesyłasz żądanie GET, a następnie przekazują wszystkie parametry w parametrach adresu URL i nagłówkach w ramach żądania. Ten w przykładzie użyto też maski pola, więc odpowiedź zawiera tylko wyświetlaną nazwę i sformatowany adres miejsca:
curl -X GET -H 'Content-Type: application/json' \ -H "X-Goog-Api-Key: API_KEY" \ -H "X-Goog-FieldMask: displayName,formattedAddress" \ https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw
Ciąg places/PLACE_ID jest również nazywany miejscem
nazwa zasobu. W odpowiedzi ze szczegółów miejsca
(Nowe), Wyszukiwanie w pobliżu (nowość) i
Żądanie wyszukiwania tekstowego (nowe) zawarte w tym ciągu
pole name odpowiedzi. Samodzielny identyfikator miejsca znajduje się w polu id odpowiedzi.