Interfejs Places API obsługuje istniejące szczegóły miejsca. Jeśli znasz już istniejący interfejs Places API, nowa wersja szczegółów miejsca wprowadza te 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 tę listę, metody zwrócą błąd. Więcej informacji znajdziesz w artykule o FieldMask.
- Nowe informacje o miejscu obsługują jako mechanizm uwierzytelniania zarówno klucze interfejsu API, jak i tokeny OAuth.
- W nowych informacjach o miejscu obsługiwany jest tylko format JSON.
- Format odpowiedzi JSON interfejsu Place Details (nowy) API został zmieniony i tym samym różni się od formatu istniejących interfejsów API. Więcej informacji znajdziesz w artykule o migracji odpowiedzi interfejsu Places API.
Poniższa tabela zawiera parametry w istniejących informacjach o miejscu, których nazwy zostały zmienione lub zmodyfikowane w przypadku nowych informacji o miejscu, a także parametry, które nie są już obsługiwane.
| Bieżący parametr | Nowy parametr | Notatki |
|---|---|---|
place_id |
places/PLACE_ID |
Ciąg znaków places/PLACE_ID jest również nazywany nazwą zasobu miejsca. W odpowiedzi na żądanie dotyczące informacji o miejscu (nowe), wyszukiwania w pobliżu (nowe) i wyszukiwania tekstowego (nowe) ten ciąg jest zawarty w polu name tej odpowiedzi.
Samodzielny identyfikator miejsca jest zawarty w polu id odpowiedzi. |
language |
languageCode |
|
region |
regionCode |
Przykładowe żądanie
Poniższe przykładowe żądanie GET korzysta z istniejących szczegółów miejsca. W tym przykładzie żądasz odpowiedzi JSON z informacjami o identyfikatorze miejsca i przekazujesz wszystkie parametry jako parametry adresu URL. W tym przykładzie użyto też właściwości fields, więc odpowiedź zawiera tylko wyświetlaną nazwę 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'
W przypadku szczegółów miejsca (nowe) wysyłasz żądanie GET i przekazujesz w nim wszystkie parametry w parametrach adresu URL i nagłówkach. W tym przykładzie zastosowano też maskę pola, dzięki czemu 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 znaków places/PLACE_ID jest również nazywany nazwą zasobu miejsca. W odpowiedzi na żądanie dotyczące informacji o miejscu (nowe), wyszukiwania w pobliżu (nowe) i wyszukiwania tekstowego (nowe) ten ciąg jest zawarty w polu name odpowiedzi. Samodzielny identyfikator miejsca jest zawarty w polu id odpowiedzi.