Yer Ayrıntıları (Yeni)

Platform seçin: Android iOS JavaScript Web Hizmeti
Avrupa Ekonomik Alanı (AEA) geliştiricileri

Giriş

Yer kimliğiniz olduğunda, Yer Ayrıntıları (Yeni) isteği başlatarak belirli bir kuruluş veya önemli yer hakkında daha fazla ayrıntı isteyebilirsiniz. Yer Ayrıntıları (Yeni) isteği, belirtilen yerle ilgili daha kapsamlı bilgiler (ör. tam adresi, telefon numarası, kullanıcı puanı ve yorumları) döndürür.

Yer kimliği edinmenin birçok yolu vardır. Şunları kullanabilirsiniz:

API Gezgini, API ve API seçeneklerine aşina olabilmeniz için canlı isteklerde bulunmanıza olanak tanır:

Yer Ayrıntıları (Yeni) istekleri

Yer Ayrıntıları (Yeni) isteği, şu biçimde bir HTTP GET isteğidir:

https://places.googleapis.com/v1/places/PLACE_ID

Tüm parametreleri URL parametreleri olarak veya üst bilgilerde GET isteğinin bir parçası olarak iletin. Örneğin:

https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw?fields=id,displayName&key=API_KEY

Alternatif olarak bir curl komutunda:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Yer Ayrıntıları (Yeni) yanıtları

Yer Ayrıntıları (Yeni), yanıt olarak bir JSON nesnesi döndürür. Yanıtın içinde:

  • Yanıt, Place nesnesiyle gösterilir. Place nesnesi, yerle ilgili ayrıntılı bilgiler içerir.
  • İstekle iletilen FieldMask, Place nesnesinde döndürülen alanların listesini belirtir.

Tam JSON nesnesi şu biçimdedir:

{
  "name": "places/ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "id": "ChIJkR8FdQNB0VQRm64T_lv1g1g",
  "displayName": {
    "text": "Trinidad"
  }
  ...
}

Gerekli parametreler

  • FieldMask

    Yanıt alan maskesi oluşturarak yanıtta döndürülecek alanların listesini belirtin. URL parametresi $fields veya fields'yi ya da HTTP üst bilgisi X-Goog-FieldMask'yi kullanarak yanıt alan maskesini yönteme iletin. Yanıtta döndürülen alanların varsayılan bir listesi yoktur. Alan maskesini atlarsanız yöntem hata döndürür.

    Gereksiz veri istemediğinizden emin olmak için alan maskeleme iyi bir tasarım uygulamasıdır. Bu sayede gereksiz işlem süresinden ve faturalandırma ücretlerinden kaçınabilirsiniz.

    Döndürülecek yer verisi türlerinin virgülle ayrılmış listesini belirtin. Örneğin, yerin görünen adını ve adresini almak için.

    X-Goog-FieldMask: displayName,formattedAddress

    Tüm alanları almak için * öğesini kullanın.

    X-Goog-FieldMask: *

    Aşağıdaki alanlardan birini veya daha fazlasını belirtin:

    • Aşağıdaki alanlar Place Details Essentials IDs Only SKU'yu (Yalnızca Yer Ayrıntıları Temel Bilgileri Kimlikleri SKU'su) tetikler:

      attributions
      consumerAlert
      id
      movedPlace
      movedPlaceId
      name*
      photos

      * name alanı, places/PLACE_ID biçiminde yer kaynak adını içerir. Yerin metin adını almak için Pro SKU'da displayName alanını isteyin.

      Alanların ve ilişkili SKU'larının tam listesi için Yer Veri Alanları (Yeni) başlıklı makaleyi inceleyin.

    • Aşağıdaki alanlar Yer Ayrıntıları Essentials SKU'sunu tetikler:

      addressComponents
      addressDescriptor*
      adrFormatAddress
      formattedAddress
      location
      plusCode
      postalAddress
      shortFormattedAddress
      types
      viewport

      * Adres tanımlayıcıları Hindistan'daki müşteriler için genel kullanıma sunulmuştur ve diğer yerlerde deneysel olarak kullanılabilir.

      Alanların ve ilişkili SKU'larının tam listesi için Yer Veri Alanları (Yeni) başlıklı makaleyi inceleyin.

    • Aşağıdaki alanlar Yer Ayrıntıları Pro SKU'sunu tetikler:

      accessibilityOptions
      businessStatus
      containingPlaces
      displayName
      googleMapsLinks
      googleMapsTypeLabel
      googleMapsUri
      iconBackgroundColor
      iconMaskBaseUri
      openingDate
      primaryType
      primaryTypeDisplayName
      pureServiceAreaBusiness
      subDestinations
      timeZone
      utcOffsetMinutes

      Alanların ve ilişkili SKU'larının tam listesi için Yer Veri Alanları (Yeni) başlıklı makaleyi inceleyin.

    • Aşağıdaki alanlar Yer Ayrıntıları Kurumsal SKU'yu tetikler:

      currentOpeningHours
      currentSecondaryOpeningHours
      internationalPhoneNumber
      nationalPhoneNumber
      priceLevel
      priceRange
      rating
      regularOpeningHours
      regularSecondaryOpeningHours
      transitStation
      userRatingCount
      websiteUri

      Alanların ve ilişkili SKU'larının tam listesi için Yer Veri Alanları (Yeni) başlıklı makaleyi inceleyin.

    • Aşağıdaki alanlar Yer Ayrıntıları Enterprise + Atmosfer SKU'sunu tetikler:

      allowsDogs
      curbsidePickup
      delivery
      dineIn
      editorialSummary
      evChargeAmenitySummary
      evChargeOptions
      fuelOptions
      generativeSummary
      goodForChildren
      goodForGroups
      goodForWatchingSports
      liveMusic
      menuForChildren
      neighborhoodSummary
      parkingOptions
      paymentOptions
      outdoorSeating
      reservable
      restroom
      reviews
      reviewSummary
      routingSummaries*
      servesBeer
      servesBreakfast
      servesBrunch
      servesCocktails
      servesCoffee
      servesDessert
      servesDinner
      servesLunch
      servesVegetarianFood
      servesWine
      takeout

      * Yalnızca Metin Arama ve Yakınlardaki Arama

      Alanların ve ilişkili SKU'larının tam listesi için Yer Veri Alanları (Yeni) başlıklı makaleyi inceleyin.

  • placeId

    Bir yeri benzersiz şekilde tanımlayan ve Metin Arama (Yeni) veya Yakında Arama (Yeni)'dan döndürülen metin tanımlayıcısı. Yer kimlikleri hakkında daha fazla bilgi için Yer kimliği genel bakış başlıklı makaleyi inceleyin.

    places/PLACE_ID dizesine yer kaynak adı da denir. Yer Ayrıntıları (Yeni), Yakında Arama (Yeni) ve Metin Arama (Yeni) isteğinden gelen yanıtta bu dize, yanıtın name alanında yer alır. Bağımsız yer kimliği, yanıtın id alanında yer alır.

İsteğe bağlı parametreler

  • languageCode

    Sonuçların döndürüleceği dil.

    • Desteklenen dillerin listesini inceleyin. Google, desteklenen dilleri sık sık güncellediği için bu liste kapsamlı olmayabilir.
    • languageCode sağlanmazsa API varsayılan olarak en değerini kullanır. Geçersiz bir dil kodu belirtirseniz API INVALID_ARGUMENT hatası döndürür.
    • API, hem kullanıcı hem de yerel halk tarafından okunabilir bir açık adres sağlamak için elinden geleni yapar. Bu hedefi gerçekleştirmek için tercih edilen dili dikkate alarak sokak adreslerini yerel dilde döndürür. Gerekirse adresler, kullanıcı tarafından okunabilir bir alfabeye çevrilir. Diğer tüm adresler tercih edilen dilde döndürülür. Adres bileşenlerinin tümü, ilk bileşenden seçilen aynı dilde döndürülür.
    • Bir ad tercih edilen dilde kullanılamıyorsa API en yakın eşleşmeyi kullanır.
    • Tercih edilen dil, API'nin döndürmeyi seçtiği sonuç kümesi ve bu sonuçların döndürülme sırası üzerinde küçük bir etkiye sahiptir. Coğrafi kodlayıcı, kısaltmaları dile bağlı olarak farklı şekilde yorumlar. Örneğin, sokak türlerinin kısaltmaları veya bir dilde geçerli olup başka bir dilde geçerli olmayan eş anlamlılar.

  • regionCode

    Yanıtı biçimlendirmek için kullanılan bölge kodu, iki karakterli CLDR kodu değeri olarak belirtilir. Varsayılan değer yoktur.

    Yanıttaki formattedAddress alanının ülke adı regionCode ile eşleşiyorsa ülke kodu formattedAddress alanından çıkarılır. Bu parametrenin, her zaman ülke adını içeren adrFormatAddress veya hiçbir zaman ülke adını içermeyen shortFormattedAddress üzerinde etkisi yoktur.

    Bazı önemli istisnalar dışında çoğu CLDR kodu, ISO 3166-1 kodlarıyla aynıdır. Örneğin, Birleşik Krallık'ın ccTLD'si "uk" (.co.uk), ISO 3166-1 kodu ise "gb"dir (teknik olarak "Büyük Britanya ve Kuzey İrlanda Birleşik Krallığı" tüzel kişiliği için). Parametre, geçerli yasaya göre sonuçları etkileyebilir.

  • sessionToken

    Oturum jetonları, kullanıcı tarafından oluşturulan ve otomatik tamamlama (yeni) çağrılarını "oturum" olarak izleyen dizelerdir. Otomatik Tamamlama (Yeni), faturalandırma amacıyla kullanıcının otomatik tamamlama aramasıyla ilgili sorgu ve yer seçimi aşamalarını ayrı bir oturumda gruplandırmak için oturum jetonlarını kullanır. Oturum jetonları, Otomatik Tamamlama (Yeni) çağrılarından sonra gelen Yer Ayrıntıları (Yeni) çağrılarına iletilir. Daha fazla bilgi için Oturum jetonları başlıklı makaleyi inceleyin.

Yer Ayrıntıları (Yeni) örneği

Aşağıdaki örnekte, placeId kullanılarak bir yerin ayrıntıları isteniyor:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

X-Goog-FieldMask üstbilgisinin, yanıtın aşağıdaki veri alanlarını içerdiğini belirttiğini unutmayın: id,displayName. Yanıt şu biçimde olur:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Ek bilgiler döndürmek için alan maskesine daha fazla veri türü ekleyin. Örneğin, formattedAddress,plusCode ekleyerek adresi ve Plus Code'u yanıta dahil edin:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,formattedAddress,plusCode" \
https://places.googleapis.com/v1/places/ChIJj61dQgK6j4AR4GeTYWZsKWw

Yanıt artık şu biçimde:

{
  "id": "ChIJj61dQgK6j4AR4GeTYWZsKWw",
  "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
  "plusCode": {
    "globalCode": "849VCWC7+RW",
    "compoundCode": "CWC7+RW Mountain View, CA, USA"
  },
  "displayName": {
    "text": "Googleplex",
    "languageCode": "en"
  }
}

Adres tanımlayıcılarını alma

Adres tanımlayıcıları, yakındaki önemli noktalar ve kapsayan alanlar da dahil olmak üzere bir yerin konumuyla ilgili ilişkisel bilgiler sağlar.

Aşağıdaki örnekte, San Jose'deki bir alışveriş merkezinde bulunan bir mağaza için yer ayrıntıları (yeni) isteği gösterilmektedir. Bu örnekte, alan maskesine addressDescriptors eklersiniz:

  curl -X GET https://places.googleapis.com/v1/places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4 \
  -H 'Content-Type: application/json' -H "X-Goog-Api-Key: API_KEY" \
  -H "X-Goog-FieldMask: name,displayName,addressDescriptor"

Yanıt; istekte belirtilen yeri, yakındaki önemli yerlerin listesini ve bu yerlerin belirtilen yere olan mesafesini, ayrıca alanların listesini ve bu alanların belirtilen yerle olan kapsama ilişkisini içerir:

  {
    "name": "places/ChIJ8WvuSB7Lj4ARFyHppkxDRQ4",
    "displayName": {
      "text": "Macy's",
      "languageCode": "en"
    },
    "addressDescriptor": {
      "landmarks": [
        {
          "name": "places/ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "placeId": "ChIJVVVVUB7Lj4ARXyb4HFVDV8s",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "food",
            "movie_theater",
            "point_of_interest",
            "restaurant",
            "shoe_store",
            "shopping_mall",
            "store"
          ],
          "spatialRelationship": "WITHIN",
          "straightLineDistanceMeters": 220.29175
        },
        {
          "name": "places/ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "placeId": "ChIJ62_oCR7Lj4AR_MGWkSPotD4",
          "displayName": {
            "text": "Nordstrom",
            "languageCode": "en"
          },
          "types": [
            "clothing_store",
            "department_store",
            "establishment",
            "point_of_interest",
            "shoe_store",
            "store"
          ],
          "straightLineDistanceMeters": 329.45178
        },
        {
          "name": "places/ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "placeId": "ChIJmx1c5x7Lj4ARJXJy_CU_JbE",
          "displayName": {
            "text": "Monroe Parking Garage",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "parking",
            "point_of_interest"
          ],
          "straightLineDistanceMeters": 227.05153
        },
        {
          "name": "places/ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "placeId": "ChIJxcwBziHLj4ARUQLAvtzkRCM",
          "displayName": {
            "text": "Studios Inn by Daiwa Living California Inc.",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "lodging",
            "point_of_interest",
            "real_estate_agency"
          ],
          "straightLineDistanceMeters": 299.9955
        },
        {
          "name": "places/ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "placeId": "ChIJWWIlNx7Lj4ARpe1E0ob-_GI",
          "displayName": {
            "text": "Din Tai Fung",
            "languageCode": "en"
          },
          "types": [
            "establishment",
            "food",
            "point_of_interest",
            "restaurant"
          ],
          "straightLineDistanceMeters": 157.70943
        }
      ],
      "areas": [
        {
          "name": "places/ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "placeId": "ChIJb3F-EB7Lj4ARnHApQ_Hu1gI",
          "displayName": {
            "text": "Westfield Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "placeId": "ChIJXYuykB_Lj4AR1Ot8nU5q26Q",
          "displayName": {
            "text": "Valley Fair",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        },
        {
          "name": "places/ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "placeId": "ChIJtYoUX2DLj4ARKoKOb1G0CpM",
          "displayName": {
            "text": "Central San Jose",
            "languageCode": "en"
          },
          "containment": "WITHIN"
        }
      ]
    }
  }

Taşınan bir yerin ayrıntılarını alma

Uygulamanızda referans verilen bir yer taşındıysa yeni yerin ayrıntılarını almak için movedPlace ve movedPlaceId alanlarını kullanabilirsiniz.

Kalıcı olarak kapalı olan yerler için Yer Ayrıntıları (Yeni), yanıt gövdesindeki businessStatus alanında CLOSED_PERMANENTLY değerini döndürür ve movedPlace ile movedPlaceId alanlarını atlar.

Yeni bir konuma taşınan yerler için Yer Ayrıntıları (Yeni), CLOSED_PERMANENTLY alanında businessStatus değerini, yanıt gövdesinin movedPlace ve movedPlaceId alanlarında ise yeni konumu döndürür.

Taşınmamış yerler için Yer Ayrıntıları (Yeni), yanıt gövdesinde movedPlace veya movedPlaceId döndürmez.

Aşağıdaki örnek istekte, Kanada'nın Quebec eyaletindeki Marche IGA St-Canut hakkında yer bilgisi isteniyor:

curl -X  GET -H 'Content-Type: application/json' \
-H 'x-Goog-Api-Key: API_KEY' \
-H 'X-Goog-FieldMask: id,displayName,businessStatus,movedPlace,movedPlaceId' \
https://places.googleapis.com/v1/places/ChIJUfQdGInVzkwRzAjmjzWB7CQ

İstek aşağıdaki yanıtı döndürür:

{
  "id": "ChIJUfQdGInVzkwRzAjmjzWB7CQ",
  "businessStatus": "CLOSED_PERMANENTLY",
  "displayName": {
    "text": "Marche IGA St-Canut",
    "languageCode": "en"
  },
  "movedPlace": "places/ChIJ36QT7n8qz0wRDqVZ_UBlUlQ",
  "movedPlaceId": "ChIJ36QT7n8qz0wRDqVZ_UBlUlQ"
}

Yeni yerle ilgili ayrıntı istemek için yeni bir Yer Ayrıntıları (Yeni) isteğinde movedPlace alanında Yer kaynağı adını kullanın.

Birden fazla kez taşınmış yerlerin mevcut konumuyla ilgili ayrıntıları almak için birden fazla zincirleme Yer Ayrıntıları (Yeni) isteği göndermeniz gerekebilir. Bir yer sonucunun movedPlace ve movedPlaceId alanları yalnızca bir sonraki konumu gösterir, bilinen son konumu göstermez. Bir yer, Yer Ayrıntıları (Yeni) isteğinde yanıt gövdesindeki movedPlace ve movedPlaceId alanları atlanırsa mevcut konumundadır.

İleride açılacak işletmeleri bulma

Gelecekte açılması beklenen işletmeler hakkında ayrıntılı bilgi isteyebilirsiniz. Yakındaki Arama (Yeni), beklenen açılış tarihi en az ayı içeriyorsa ve 90 günden daha kısa bir süre sonra ise openingDate alanını doldurur.

Aşağıdaki örnekte, New Meadows, Idaho'da gelecekte açılacak bir işletme için Yakındaki Arama (Yeni) isteği gösterilmektedir:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,businessStatus,openingDate" \
"https://places.googleapis.com/v1/places/ChIJp1-VoKWJplQRMz8g-7Wa3Do"

Yanıtta, yerin işletme durumu ve beklenen açılış tarihi yer alır:

{
  "id": "ChIJp1-VoKWJplQRMz8g-7Wa3Do",
  "businessStatus": "FUTURE_OPENING",
  "openingDate": {
    "year": 2026,
    "month": 4,
    "day": 15
  }
}

Toplu taşıma istasyonu bilgilerini alma

Toplu taşıma istasyonları hakkında bilgi edinmek için Yer Ayrıntıları (Yeni) özelliğini kullanabilirsiniz. Yanıt gövdesinde, istasyon adı, bağlı toplu taşıma operatörleri ve istasyona hizmet veren toplu taşıma hatları da dahil olmak üzere istasyonla ilgili bilgiler yer alır. Ayrıca, yanıtta toplu taşıma istasyonu bilgilerini göstermek için kullanabileceğiniz bir araç simgesi ve renkler yer alır.

Aşağıdaki örnekte, Grand Central İstasyonu için toplu taşıma istasyonu bilgileri isteği gösterilmektedir:

curl -X GET \
-H "Content-Type: application/json" \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,transitStation" \
"https://places.googleapis.com/v1/places/ChIJLVaKiQFZwokRgcybX3K6Pzg"

Yanıt gövdesinde, yarıçap içindeki her istasyon, istasyonun hizmet verdiği hatlar, durakta toplu taşıma kuruluşları tarafından verilen uyarılar ve kalkış bilgileri hakkında bilgiler yer alır:

  {
  "id": "ChIJLVaKiQFZwokRgcybX3K6Pzg",
  "displayName": {
    "text": "Grand Central",
    "languageCode": "en"
  },
  "transitStation": {
    "displayName": {
      "text": "Grand Central",
      "languageCode": "en"
    },
    "agencies": [
      {
        "displayName": {
          "text": "MTA New York City Transit",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/",
        "lines": [
          {
            "id": "ChIJ420yFwBZwokR903kVZLSsFc",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "42 St Shuttle",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "S",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#808183",
            "url": "https://www.mta.info/schedules/subway/42-st-shuttle",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/S.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          },
          {
            "id": "ChIJDdd_uEdfwokRHbLvWrdBdDM",
            "vehicleType": "SUBWAY",
            "displayName": {
              "text": "5 Train (Lexington Av Express)",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "5 Line",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#00933C",
            "url": "https://www.mta.info/schedules/subway/5-train",
            "icon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/us-ny-mta/5.svg",
              "nameIncluded": true
            },
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/subway2.svg"
            }
          }
          ...
        ]
      },
      {
        "displayName": {
          "text": "MTA",
          "languageCode": "en"
        },
        "url": "https://new.mta.info/",
        "lines": [
          {
            "id": "ChIJcwVpzKpZwokR24EBeh8arww",
            "vehicleType": "BUS",
            "displayName": {
              "text": "United Nations - W 42 St Pier",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "M42",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#1D59B3",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/bus2.svg"
            }
          }
        ]
      },
      {
        "displayName": {
          "text": "Long Island Rail Road",
          "languageCode": "en"
        },
        "url": "http://www.mta.info/lirr",
        "lines": [
          {
            "id": "ChIJv9m8uWM56IkRUcVBQ6Q_In0",
            "vehicleType": "HEAVY_RAIL",
            "displayName": {
              "text": "Ronkonkoma Branch",
              "languageCode": "en"
            },
            "shortDisplayName": {
              "text": "LIRR",
              "languageCode": "en"
            },
            "textColor": "#FFFFFF",
            "backgroundColor": "#A626AA",
            "vehicleIcon": {
              "url": "https://maps.gstatic.com/mapfiles/transit/iw2/svg/rail2.svg"
            }
          }
          ...
        ]
      }
    ],
    "stops": [
      {
        "id": "ChIJRcemlf1YwokRhFqqw5jKBFM",
        "stopCode": {
          "text": "GCT"
        },
        "location": {
          "latitude": 40.755161,
          "longitude": -73.975456
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJ57l2zANZwokRD1pyhuwpfKY",
        "signageText": {
          "text": "34 St-Hudson Yards & Main St-Flushing, Queens, 7",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.750983,
          "longitude": -73.9750686
        },
        "wheelchairAccessibleEntrance": true
      },
      {
        "id": "ChIJoVXJgQFZwokR1yzq_WVuEuc",
        "displayName": {
          "text": "E 42 St/Park Av",
          "languageCode": "en"
        },
        "location": {
          "latitude": 40.7518199,
          "longitude": -73.9771918
        },
        "wheelchairAccessibleEntrance": true
      }
      ...
    ]
  }
}

Girişleri ve navigasyon noktalarını görme

Bir hedef için giriş ve gezinme noktaları isteyebilirsiniz. Girişler, bir yerin giriş ve çıkış noktalarını (ör. havalimanı veya alışveriş merkezindeki farklı kapılar) tanımlar. Gezinme noktaları, gezinmenin sona ermesi gereken yol kenarı konumlarını tanımlar. Bu, kullanıcıları yolun doğru tarafına veya belirli bir bırakma noktasına yönlendirmek için kullanışlıdır.

Navigasyon noktaları navigationPointToken döndürür. Sürücüleri belirli bir konuma yönlendirmek için bu jetonu Navigasyon SDK'sına (Android veya iOS için kullanılabilir) ya da Routes API'ye iletebilirsiniz. Daha fazla bilgi için Gezinme noktası jetonları başlıklı makaleyi inceleyin.

Aşağıdaki örnekte, alan maskesinde entrances ve navigationPoints dahil olmak üzere San Francisco Uluslararası Havaalanı (yer kimliği ChIJVVVVVYx3j4ARP-3NGldc8qQ) ile ilgili ayrıntılar istenmektedir:

curl -X GET -H 'Content-Type: application/json' \
-H "X-Goog-Api-Key: API_KEY" \
-H "X-Goog-FieldMask: id,displayName,entrances,navigationPoints" \
https://places.googleapis.com/v1/places/ChIJVVVVVYx3j4ARP-3NGldc8qQ

Yanıtta, yerin girişleri ve gezinme noktaları yer alıyor:

{
  "id": "ChIJVVVVVYx3j4ARP-3NGldc8qQ",
  "displayName": {
    "text": "San Francisco International Airport",
    "languageCode": "en"
  },
  "entrances": [
    {
      "location": {
        "latitude": 37.6172154,
        "longitude": -122.3839724
      }
    },
    {
      "location": {
        "latitude": 37.6174073,
        "longitude": -122.384196
      }
    },
    ...
  ],
  "navigationPoints": [
    {
      "navigationPointToken": "ChIJoioBjMLOQkAR0A3yH_eYXsA...",
      "displayName": {
        "text": "International Terminal Departures Level",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6153121,
        "longitude": -122.3900833
      },
      "travelModes": ["WALK"]
    },
    {
      "navigationPointToken": "ChIJy5JKws_OQkAROx0jNN2YXsA...",
      "displayName": {
        "text": "Domestic Garage - SFO Short Term Parking",
        "languageCode": "en"
      },
      "location": {
        "latitude": 37.6157153,
        "longitude": -122.3885012
      },
      "travelModes": ["DRIVE", "WALK"],
      "usages": ["PARKING"]
    },
    ...
  ]
}

Deneyin.

API Gezgini, API ve API seçeneklerine alışabilmeniz için örnek istekler göndermenize olanak tanır.

  1. Sayfanın sağ tarafındaki API simgesini api seçin.

  2. İsteğe bağlı olarak istek parametrelerini düzenleyin.

  3. Yürüt düğmesini seçin. İletişim kutusunda, isteği göndermek için kullanmak istediğiniz hesabı seçin.

  4. API Gezgini penceresini genişletmek için API Gezgini panelinde tam ekran simgesini fullscreen seçin.