Link do Map Google

Interfejs Places API (nowy) akceptuje żądania danych o miejscach za pomocą różnych metod. Odpowiedź z interfejsu Places API (nowego) zawiera dane o miejscu, w tym dane o lokalizacji i obrazy, lokalizacje geograficzne oraz ważne punkty orientacyjne.

Odpowiedź z interfejsów Text Search (New), Nearby Search (New) i Place Details (New) 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ędzynarodowe lotnisko w 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 do niego trasy, wyświetlanie opinii o nim i jego zdjęć.

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

• 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 API Explorer umożliwia wysyłanie żądań w czasie rzeczywistym, dzięki czemu możesz zapoznać się z tymi nowymi opcjami:

Wypróbuj

Obsługiwane linki do miejsca w Mapach Google

W tabeli poniżej znajdziesz linki do Map Google, które możesz umieścić w odpowiedzi:

Uwzględnij wszystkie linki w odpowiedzi dotyczącej Miejsc

Linki w odpowiedzi dotyczącej miejsca znajdują się w polu googleMapsLinks. Jeśli chcesz, aby te pola były widoczne w odpowiedzi, pamiętaj, aby uwzględnić pole googleMapsLinks w masce pola żądania.

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

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"
      }
    }
  ]
}

Umieszczanie w odpowiedzi konkretnego linku

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 wskazówek w odpowiedzi

Wszystkie metody Places obsługują generowanie linku do wskazówek dojazdu w odpowiedzi. Bieżąca lokalizacja jest używana jako punkt początkowy, lokalizacja miejsca jako punkt docelowy, a tryb podróży to jazda samochodem.

W następnym przykładzie używamy wyszukiwania w pobliżu (nowego), aby w odpowiedzi w polu directionsUri umieścić link do wskazówek dojazdu w Mapach:

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

Dodawanie linków do opinii i zdjęć

W tej wersji dodaliśmy pole googleMapsUri do obiektów Reviews i Photos w odpowiedzi. Otwarcie tych linków spowoduje wyświetlenie 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 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 api ikonę API.

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

3. Opcjonalnie edytuj treść żądania.

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

5. W panelu API Explorer kliknij  fullscreen .

   Pełny ekran, aby rozwinąć okno narzędzia API Explorer.