Przenieś do Szczegółów miejsca (nowość)

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

Wprowadzenie

Interfejs Places API obsługuje szczegóły miejsca (starsza wersja). Jeśli znasz interfejs Places API (starsza wersja), Place Details (nowy) wprowadza następujące zmiany:

  • Maskowanie pola 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 sekcji FieldMask.
  • Szczegóły miejsca (nowe) obsługują zarówno klucze interfejsu API, jak i tokeny OAuth jako mechanizm uwierzytelniania.
  • W przypadku szczegółów miejsca (nowych) jako format odpowiedzi obsługiwany jest tylko JSON.
  • Format odpowiedzi JSON w przypadku interfejsu Places API (New) zmienił się w porównaniu z formatem starszych interfejsów API. Więcej informacji znajdziesz w artykule Migracja odpowiedzi interfejsu Places API.

W tabeli poniżej znajdziesz listę parametrów w usłudze Szczegóły miejsca (starsza wersja), które zostały zmienione lub zmodyfikowane w usłudze Szczegóły miejsca (nowa wersja), oraz parametrów, które nie są już obsługiwane.

Bieżący 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 szczegółów miejsca (nowe), wyszukiwania w pobliżu (nowe) i wyszukiwania tekstowego (nowe) ten ciąg znaków znajduje się w polu name odpowiedzi. Samodzielny identyfikator miejsca znajduje się w polu id w odpowiedzi.
language languageCode
region regionCode

Przykładowe żądanie

Ten przykładowy kod wysyła żądanie GET do usługi Place Details (starsza wersja). W tym przykładzie wysyłasz żądanie odpowiedzi w formacie JSON zawierającej informacje o identyfikatorze miejsca i przekazujesz wszystkie parametry jako parametry adresu URL. W tym przykładzie użyto też parametru 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 (nowych) wysyłasz żądanie GET i przekazujesz wszystkie parametry w parametrach adresu URL i nagłówkach w ramach żądania. W tym przykładzie używamy też maski pola, aby odpowiedź zawierała 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 szczegółów miejsca (nowe), wyszukiwania w pobliżu (nowe) i wyszukiwania tekstowego (nowe) ten ciąg znaków znajduje się w polu name odpowiedzi. Samodzielny identyfikator miejsca znajduje się w polu id w odpowiedzi.

.