Wprowadzenie
Places API obsługuje informacje o miejscu (wersja starsza). Jeśli znasz Places API (wersja starsza), informacja o miejscu (nowa) wprowadzono te zmiany:
- Maskowanie pól jest wymagane. Musisz określić, które pola mają być zwracane w odpowiedzi. Nie ma domyślnej listy zwracanych pól. Jeśli pominiesz tę listę, metody zwrócą błąd. Więcej informacji znajdziesz w artykule FieldMask.
- Informacje o miejscu (nowa) obsługują zarówno klucze API i OAuth jako mechanizm uwierzytelniania.
- W przypadku informacji o miejscu (nowa) obsługiwany jest tylko format JSON.
- Format odpowiedzi JSON w Places API (nowa) różni się od formatu starszych interfejsów API. Więcej informacji znajdziesz w artykule Migracja odpowiedzi Places API.
W tabeli poniżej znajdziesz listę parametrów w informacji o miejscu (wersja starsza), które zostały zmienione lub zmodyfikowane w informacji o miejscu (nowa), oraz parametrów, które nie są już obsługiwane.
| Aktualny parametr | Nowy parametr | Uwagi |
|---|---|---|
place_id |
places/PLACE_ID |
Ciąg znaków places/PLACE_ID jest też nazywany
nazwą zasobu miejsca. W odpowiedzi na żądanie informacji o miejscu (nowa),
wyszukiwania w pobliżu (nowa) i wyszukiwania tekstowego (nowa)
ten ciąg znaków znajduje się w polu name odpowiedzi.
Samodzielny identyfikator miejsca znajduje się w polu id odpowiedzi. |
language |
languageCode |
|
region |
regionCode |
Przykładowe żądanie
Ten przykładowy kod wysyła żądanie GET do informacji o miejscu (wersja starsza). W tym przykładzie żądasz odpowiedzi JSON zawierającej informacje o identyfikatorze miejsca i przekazujesz wszystkie parametry jako parametry adresu URL. Ten przykład używa też fields, dzięki czemu 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 informacji o miejscu (nowa) wysyłasz żądanie GET i przekazujesz wszystkie parametry w parametrach adresu URL i nagłówkach w ramach żądania. Ten przykład używa też maski 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 też nazywany
nazwą zasobu miejsca. W odpowiedzi na żądanie informacji o miejscu (nowa), wyszukiwania w pobliżu (nowa) i wyszukiwania tekstowego (nowa) ten ciąg znaków znajduje się w polu name odpowiedzi. Samodzielny identyfikator miejsca znajduje się w polu id odpowiedzi.