Link do Map Google

Interfejs Places API akceptuje żądania dotyczące danych o miejscach za pomocą różnych metod. Odpowiedź interfejsu Places API zawiera dane o miejscu, w tym dane o lokalizacji i obrazy, lokalizacje geograficzne oraz ważne punkty zainteresowania.

W ramach tej wersji odpowiedzi z wyszukiwania tekstowego, wyszukiwania w pobliżu i szczegółowych informacji o miejscu mogą też zawierać linki do Map Google. Użytkownicy mogą kliknąć te linki do Map Google, aby wyświetlić dodatkowe informacje o miejscu w odpowiedzi.

Na przykład szukasz lotnisk w San Francisco w Kalifornii. Odpowiedź zawiera następnie międzynarodowe lotnisko w San Francisco (SFO) na liście miejsc. W ramach tej wersji obiekt Place dla lotniska w San Francisco w odpowiedzi zawiera pole googleMapsUri z linkami do Map Google, które umożliwiają otwarcie Map Google, wskazówek dojazdu do miejsca, opinii o miejscu i zdjęć miejsca.

Oprócz linków dodanych do obiektu Place ta wersja wprowadza również pole googleMapsUri do obiektów Reviews i Photos w odpowiedzi:

  • Reviews.googleMapsUri: zawiera link do opinii w Mapach Google, dzięki któremu możesz ją wyświetlić w przeglądarce.

  • Photos.googleMapsUri: zawiera link do zdjęcia w Mapach Google, dzięki któremu możesz wyświetlić je w przeglądarce.

Narzędzie API Explorer umożliwia wysyłanie żądań na żywo, dzięki czemu możesz zapoznać się z tymi nowymi opcjami:

Wypróbuj

W tabeli poniżej znajdziesz linki do Map Google, które możesz uwzględnić w odpowiedzi:

Link do Map Google Opis Nazwa pola
Miejsce link do Map Google, aby otworzyć mapę miejsca; googleMapsLinks.placeUri
Instrukcje link do otwarcia trasy do danego miejsca w Mapach Google. googleMapsLinks.directionsUri
Napisz opinię link do miejsca, w którym możesz napisać opinię w Mapach Google. googleMapsLinks.writeAReviewUri
Przeczytaj opinie link do opinii o miejscu w Mapach Google; googleMapsLinks.reviewsUri
Zdjęcia link do zdjęć tego miejsca w Mapach Google; googleMapsLinks.photosUri

Ceny

Ta funkcja jest na etapie przed GA i jest bezpłatna, co oznacza, że za jej używanie w wersji testowej nie są naliczane opłaty. Szczegółowe informacje o proponowanych cenach znajdziesz w artykule Korzystanie z interfejsu Places API i powiązane rozliczenia.

Linki w odpowiedzi na pytanie o lokalizacje znajdują się w polu googleMapsLinks. Jeśli chcesz, aby te pola były widoczne w odpowiedzi, uwzględnij je w polu maski żądania.googleMapsLinks

Na przykład w wyniku wyszukiwania tekstowego znajdują się wszystkie linki do Map:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks' \
'https://places.googleapis.com/v1/places:searchText'

Odpowiedź ma postać:

{
  "places": [
    {
      "formattedAddress": "San Francisco, CA 94128, USA",
      "displayName": {
        "text": "San Francisco International Airport",
        "languageCode": "en"
      },
      "googleMapsLinks": {
        "placeUri": "https://maps.google.com/?cid=11885663895765773631",
        "directionsUri": "https://www.google.com/maps/dir//''/data=!4m7!4m6!1m1!4e2!1m2!1m1!1s0x808f778c55555555:0xa4f25c571acded3f!3e0",
        "writeAReviewUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!12e1",
        "reviewsUri": "https://www.google.com/maps/place//data=!4m4!3m3!1s0x808f778c55555555:0xa4f25c571acded3f!9m1!1b1",
        "photosUri": "https://www.google.com/maps/place//data=!4m3!3m2!1s0x808f778c55555555:0xa4f25c571acded3f!10e5"
      }
    }
  ]
}

Nie musisz zwracać wszystkich linków w odpowiedzi. Jeśli na przykład chcesz, aby w odpowiedzi znalazł się tylko link do zdjęć, zmień maskę pola, jak pokazano poniżej, aby zawierała tylko pole photosUri:

curl -X POST -d '{
  "textQuery" : "San Francisco International Airport"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.formattedAddress,places.priceLevel,places.googleMapsLinks.photosURI' \
'https://places.googleapis.com/v1/places:searchText'

Dołącz do odpowiedzi wskazówki

Wszystkie metody Places obsługują generowanie linku do wskazówek w odpowiedzi. Bieżąca lokalizacja jest używana jako punkt początkowy, lokalizacja miejsca – jako miejsce docelowe, a tryb podróży – jako samochód.

W następującym przykładzie użyto wyszukiwania w pobliżu, aby uwzględnić w odpowiedzi link do wskazówek dojazdu w Mapach Google w polu directionsUri:

curl -X POST -d '{
  "includedTypes": ["restaurant"],
  "maxResultCount": 10,
  "locationRestriction": {
    "circle": {
      "center": {
        "latitude": -33.8688,
        "longitude": 151.1957362},
      "radius": 500.0
    }
  }
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key:API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.googleMapsLinks.directionsUri' \
https://places.googleapis.com/v1/places:searchNearby

W tej wersji dodano pole googleMapsUri do obiektów Reviews i Photos w odpowiedzi. Kliknięcie tych linków powoduje otwarcie opinii lub zdjęcia w Mapach Google.

Na przykład ta wyszukiwarka tekstowa zawiera opinie i zdjęcia każdego miejsca w odpowiedzi:

curl -X POST -d '{
  "textQuery" : "Spicy Vegetarian Food in Sydney, Australia"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: places.displayName,places.reviews,places.photos' \
'https://places.googleapis.com/v1/places:searchText'

W odpowiedzi każdy element tablicy opinii i zdjęć zawiera pole googleMapsUri, które umożliwia otwarcie opinii lub zdjęcia w przeglądarce.

Wypróbuj

Narzędzie API Explorer umożliwia wysyłanie przykładowych żądań, dzięki czemu możesz zapoznać się z interfejsem API i jego opcjami.

  1. Po prawej stronie strony kliknij ikonę interfejsu API, Rozwiń narzędzie API Explorer..

  2. Opcjonalnie rozwiń Pokaż parametry standardowe i ustaw parametr fields na maskę pola.

  3. Opcjonalnie możesz zmodyfikować tekst żądania.

  4. Kliknij przycisk Wykonaj. W oknie wybierz konto, którego chcesz użyć do wysłania prośby.

  5. W panelu API Explorer kliknij ikonę rozwijania Rozwiń narzędzie API Explorer., aby rozwinąć okno API Explorer.