Link do Map Google

Interfejs Places API (nowy) akceptuje żądania danych o miejscach wysyłane różnymi metodami. Odpowiedź interfejsu Places API (nowego) zawiera dane o miejscu, w tym dane o lokalizacji i obrazy, lokalizacje geograficzne oraz najważniejsze punkty orientacyjne.

Odpowiedź z wyszukiwania tekstowego (nowego), wyszukiwania w pobliżu (nowego) i informacji o miejscu (nowych) może 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 wyszukujesz lotniska w San Francisco w Kalifornii. Odpowiedź zawiera wtedy międzynarodowy port lotniczy San Francisco (SFO) na liście miejsc. Obiekt Place dla SFO w odpowiedzi dodaje pole googleMapsUri zawierające linki do Map Google, które umożliwiają otwieranie Map Google w miejscu, wyznaczanie trasy do miejsca, wyświetlanie opinii o miejscu i zdjęć miejsca.

Oprócz linków dodanych do obiektu Place pole googleMapsUri jest też dodawane do Reviews i Photos obiektów w odpowiedzi:

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

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

Narzędzie APIs Explorer umożliwia wysyłanie żądań w czasie rzeczywistym, 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 otwierania Map Google w miejscu. googleMapsLinks.placeUri
Trasa Link do otwierania trasy do miejsca w Mapach Google. googleMapsLinks.directionsUri
Napisz opinię Link do napisania opinii o miejscu w Mapach Google. googleMapsLinks.writeAReviewUri
Przeczytaj opinie Link do wyświetlania opinii o miejscu w Mapach Google. googleMapsLinks.reviewsUri
Zdjęcia Link do wyświetlania zdjęć miejsca w Mapach Google. googleMapsLinks.photosUri

Linki w odpowiedzi Places znajdują się w googleMapsLinks polu. Jeśli chcesz, aby linki te pojawiały się w odpowiedzi, uwzględnij pole googleMapsLinks w masce pola żądania.

Na przykład poniższe wyszukiwanie tekstowe (nowe) zawiera wszystkie linki do Map w odpowiedzi:

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 był tylko link do zdjęć, zmodyfikuj maskę pola w sposób pokazany poniżej, aby uwzględnić 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'

Uwzględnianie trasy w odpowiedzi

Wszystkie metody Places obsługują generowanie linku do trasy w odpowiedzi. Jako punkt początkowy używana jest bieżąca lokalizacja, jako miejsce docelowe – lokalizacja miejsca, a jako środek transportu – samochód.

W następnym przykładzie użyto wyszukiwania w pobliżu (nowego), aby uwzględnić w odpowiedzi link do trasy w Mapach 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 dodaliśmy 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 poniższe wyszukiwanie tekstowe (nowe) 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 otwieranie opinii lub zdjęcia w przeglądarce.

Wypróbuj

Narzędzie APIs 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.

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

  3. Opcjonalnie edytuj treść żądania.

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

  5. W panelu APIs Explorer kliknij

    Pełny ekran , aby rozwinąć okno APIs Explorer.