Link do Map Google

Interfejs Places API (New) akceptuje żądania danych o miejscach za pomocą różnych metod. Odpowiedź interfejsu Places API (New) zawiera dane o miejscu, w tym dane o lokalizacji i zdjęcia, położenie geograficzne oraz ważne ciekawe miejsca.

Odpowiedź z funkcji Wyszukaj tekst (nowej), Wyszukiwanie w pobliżu (nowej) i informacji o miejscu (nowych) może też zawierać linki do Map Google. Użytkownicy mogą kliknąć te linki do Map Google, aby zobaczyć dodatkowe informacje o miejscu w odpowiedzi.

Na przykład wyszukujesz lotniska w San Francisco w Kalifornii. Odpowiedź będzie zawierać 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ą otwarcie Map Google w miejscu, wskazówki dojazdu do miejsca, opinie o miejscu i zdjęcia miejsca.

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

• Reviews.googleMapsUri: zawiera link do Map Google, który prowadzi do opinii, 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 Map Google dotyczące miejsca

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

Uwzględnij wszystkie linki w odpowiedzi dotyczącej miejsc

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

Na przykład to wyszukiwanie tekstowe (nowe) zawiera w odpowiedzi 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 następującą 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"
      }
    }
  ]
}

umieszczenie w odpowiedzi konkretnego linku,

Nie musisz zwracać wszystkich linków w odpowiedzi. Jeśli na przykład chcesz, aby w odpowiedzi znajdował się tylko link do zdjęć, zmodyfikuj maskę pola, tak 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 wskazówki dojazdu w odpowiedzi.

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

W kolejnym przykładzie użyto wyszukiwania w pobliżu (nowego), aby uwzględnić link do wskazówek dojazdu w odpowiedzi 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

Dołącz linki do opinii i zdjęć

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

Na przykład poniższe wyszukiwanie tekstowe (nowe) zawiera opinie i zdjęcia dotyczące 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 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 kliknij ikonę interfejsu API api .

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

3. Opcjonalnie zmodyfikuj treść żądania.

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

5. W panelu API Explorer wybierz fullscreen .

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