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

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: FieldMask,
  • Nowe informacje o miejscu obsługują Klucze interfejsu API i OAuth tokeny uwierzytelniania.
  • W nowym formacie odpowiedzi obsługiwany jest tylko format JSON Szczegóły miejsca.
  • Format odpowiedzi JSON dla szczegółów miejsca (nowego) Interfejs API różni się od formatu istniejących interfejsów API. Więcej informacji: Przenieś odpowiedź interfejsu Places API.

Poniższa tabela zawiera parametry w obecnym Szczegóły miejsca, które uległy zmianie lub których dotyczą nowe informacje o miejscu lub parametry, które nie są już obsługiwane.

Bieżący parametr Nowy parametr Uwagi
place_id places/PLACE_ID Ciąg places/PLACE_ID jest również nazywany nazwa zasobu miejsca. W odpowiedzi ze szczegółów miejsca (nowość) Wyszukiwanie w pobliżu (nowość) i wyszukiwanie tekstowe (nowość) , ten ciąg będzie zawarty w polu name odpowiedzi. Samodzielny identyfikator miejsca jest zawarty 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 żądasz pliku JSON odpowiedź zawierająca informacje o identyfikatorze miejsca i przekazująca wszystkie parametry jako URL . W tym przykładzie użyto też parametru fields, więc odpowiedź zawiera tylko parametr wyświetlana nazwa 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 szczegółów miejsca (nowość) 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 jest zawarty w pliku id odpowiedzi.